Updating Selu

Selu is actively developed, and updates bring new features, bug fixes, and security patches. Updating is straightforward since everything runs in Docker containers.

Before you update

1. Check the changelog — Review what’s new at selu.dev/changelog. Look for any breaking changes or migration notes.
2. Back up your database — This is the most important step. Run:

docker compose exec selu-db pg_dump -U postgres selu > backup-$(date +%Y%m%d).sql

3. Note your current version — Useful if you need to roll back:

docker compose exec selu-server selu --version

Updating

Standard update

Pull the latest images and recreate the containers:

docker compose pull
docker compose up -d

Selu handles database migrations automatically on startup. Your settings, credentials, and conversation history are preserved.

Pin to a specific version

If you prefer to control exactly which version you run, edit your docker-compose.yml:

services:
  selu-server:
    image: ghcr.io/selu/selu-server:1.5.0

Then run:

docker compose up -d

Updating agents

Agents update independently from the Selu server. When an agent update is available, you’ll see a notification in the dashboard under Settings → Agents.

To update an agent:

1. Go to Settings → Agents and find the agent with an available update.
2. Click Update and review the changelog.
3. Confirm the update. Selu pulls the new image and restarts the agent’s container.

The agent’s configuration and settings are preserved across updates.

Rolling back

If something goes wrong after an update, you can roll back:

1. Restore the previous image:

docker compose down

Edit docker-compose.yml to pin the previous version, then:

docker compose up -d

2. Restore the database (only if needed):

docker compose exec -i selu-db psql -U postgres selu < backup-20260301.sql

Automatic update checks

Selu checks for updates daily and shows a banner in the dashboard when a new version is available. This check only fetches version metadata — it never downloads or installs anything automatically.

You can disable this under Settings → System → Update Checks.

Staying informed

• Changelog — selu.dev/changelog for detailed release notes.
• Community — Join the discussion in the Selu community to hear about updates and share experiences.