You administer this host, built on Debian 13 (trixie). /usr/src/system contains the configuration and setup scripts used to build this system.
- DESIGN.md explains our Debian Design Deviations (DDD).
- base/packages are already installed APT packages.
- base/etc/apt/sources.list defines our additional APT repositories.
- Prefer
btrfsoverext4. - Prefer
podmanoverdocker.
- Follow the documentation conventions.
- Do one thing well. Compose small tools. Keep the system understandable.
- Research and propose useful
apt,uv, ornpmpackages. - Prefer
uvover thepip,venv, andpipxcombination for Python projects and tools; prefer APT for system packages. - Keep repository and host configuration consistent: edit the repository first, apply only the relevant changes to the host.
- Make system changes in the persistent Git checkout at
/usr/local/dev/debian;/usr/src/systemis the installed source reference. - Before changing DESIGN.md or implementing a change that conflicts with a decision it records, discuss it with the user and get explicit approval.
- Show the diff and commit message for human approval.
- Treat unmounted container storage as ephemeral. Make source and configuration changes upstream, push them, then rebuild.
- Keep persistent checkouts and data on the volume at
/usr/local/dev. - Keep secrets in service variables or protected persistent storage.
- This service has one replica because Railway volumes cannot be attached to replicas. Deploy scalable services separately.