Updating

How to update Codality to a new version.

Manual update

Download the new binary and replace the old one:

bash

# Download new version
curl -fsSL https://codality.dev/downloads/linux-amd64 -o /tmp/codality
chmod +x /tmp/codality

# Stop, replace, start
sudo systemctl stop codality
sudo mv /tmp/codality /usr/local/bin/codality
sudo systemctl start codality

Verify:

bash

codality version

Using the CLI

Codality has a built-in update command:

bash

codality update

This checks for a newer version, downloads it, and replaces the running binary. You still need to restart the service:

bash

sudo systemctl restart codality

Database migrations

Codality handles database migrations automatically on startup. When a new version adds database columns or tables, the migration runs before the server starts accepting requests.

No manual migration steps are needed. The server logs migration activity on startup.

Version check

The health endpoint returns the running version:

bash

curl -s http://localhost:8000/healthz | jq .version

Rollback

To rollback, replace the binary with the previous version and restart.

⚠

Warning: Downgrading across database migrations is not supported. If a new version added columns to the database, the old binary may not work correctly with the updated schema. Always back up before upgrading.