komp_ac/packaging/musl

Portable Linux server build

This build produces one x86_64 Linux server executable with embedded PostgreSQL. The Rust program is statically linked against musl. PostgreSQL is compiled against musl and stored inside the executable.

PostgreSQL itself remains dynamically loadable so the btree_gist extension used by the migrations works. Its musl loader is included in the embedded archive, and static launcher executables invoke every PostgreSQL tool through that loader. Neither glibc, musl, PostgreSQL nor timezone data needs to be installed on the target machine.

Build directly through the repository's Nix flake:

nix build '.?submodules=1#portable-server'

Output: result/bin/server.

The resulting executable is intended for 64-bit Linux kernels. Run it normally:

cp .env_template_musl .env
# Replace JWT_SECRET in .env before starting.
./result/bin/server server

Required: JWT_SECRET.

Optional: KOMP_AC_POSTGRES_DIR selects the persistent PostgreSQL directory. DATABASE_URL and RUST_DB_* are not required in embedded mode.

The portable binary can still use a separately managed PostgreSQL server at runtime. Set RUST_DB_MODE=external and provide RUST_DB_USER, RUST_DB_PASSWORD, RUST_DB_HOST, RUST_DB_PORT and RUST_DB_NAME.

Use the external PostgreSQL build on NixOS when preferred:

cargo build --release --package server --no-default-features