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.

1. Question

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

2. 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, Valgrind, and X11/GL headers.

  2. Initialise the database before the first build:

    ./projects/ores.compass/compass.sh db recreate
    
  3. Build — compass build configures automatically on first run (see How do I configure the project? and How do I build the system?):

    ./compass.sh build
    

3. 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.

4. Tested by

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

5. See also

Emacs 29.3 (Org mode 9.6.15)