How do I set up a development environment?

Table of Contents

Run once on a fresh checkout — including WSL. For the preset menu and build commands see CMake setup.

Question

How do I set up a development environment on Ubuntu, Debian, or WSL?

Answer

  1. Install all required system packages with the bootstrap script:

    ./build/scripts/install_debian_packages.sh --full-install
    

    Installs from distro repos: GCC, Clang, CMake, Ninja, PostgreSQL, Qt6, Valgrind, and X11/GL headers.

  2. Initialise the database before the first build:

    ./projects/ores.compass/compass.sh db recreate
    
  3. Configure and build (see How do I configure the project? and How do I build the system?):

    cmake --preset linux-clang-debug-ninja
    cmake --build --preset linux-clang-debug-ninja
    

Script

build/scripts/install_debian_packages.sh — one-shot package installer. compass db recreate — drops and recreates all ORE Studio databases with the current schema.

Tested by

Manual, once per fresh environment. CI uses pre-configured runners and does not exercise this path.

See also

Emacs 29.1 (Org mode 9.6.6)