Linux / Debian

What you will do

Install the Debian package for your CPU architecture, configure Codifix, enable the backend service, and run health checks.

Before you start

Install PostgreSQL and pgvector first, or use a reachable PostgreSQL server with the vector extension enabled.

Release packages are published for:

• x86_64 Debian/Ubuntu: codifix_2.0.0_amd64.deb
• arm64 Debian/Ubuntu: codifix_2.0.0_arm64.deb

The arm64 package is the Raspberry Pi 4/5 path when the Pi runs a 64-bit Debian-family OS. 32-bit Raspberry Pi OS is not a release target yet.

Steps

# x86_64
sudo dpkg -i codifix_2.0.0_amd64.deb

# arm64 / Raspberry Pi 4/5 with a 64-bit OS
sudo dpkg -i codifix_2.0.0_arm64.deb

codifix wizard --global
cd /path/to/project
codifix wizard --dry-run
codifix wizard
sudo systemctl enable --now codifix.service
codifix doctor
codifix health
codifix tui

Use the v2.0.0 GitHub release assets and verify the matching .sha256 file before installation. If dpkg reports missing dependencies, install those packages with your normal package manager and rerun the package install.

Verify

codifix --version
systemctl status codifix.service
codifix status --project <project-slug>

Troubleshooting

• codifix command not found: open a new shell or check the package install path.
• connection refused: verify the service is running and the configured port matches.
• extension "vector" is not available: install the pgvector package for your PostgreSQL major version.

Next

Read Service setup and Doctor and health.