Panel

Updating

How to update the Struxa Panel to a new version.

Using the Installer Script

If you installed with the official script, updating is a single command:

bash <(curl -fsSL https://install.struxa.cloud) update

This reads the current version from /opt/struxa/.env.prod, fetches the latest release tag, updates the image, pulls, and restarts automatically.

For the nightly channel:

bash <(curl -fsSL https://install.struxa.cloud) update --nightly

Manual Update

If you prefer to update manually:

Before You Update

  • Back up your database if doing a major version upgrade

Pull and Restart

cd /opt/struxa
docker compose -f docker-compose.prod.yml --env-file .env.prod pull
docker compose -f docker-compose.prod.yml --env-file .env.prod up -d

Database migrations run automatically on startup.

Viewing Logs

cd /opt/struxa

# Panel logs
docker compose -f docker-compose.prod.yml logs -f web

# Database logs
docker compose -f docker-compose.prod.yml logs -f mysql

Restart Panel Only

docker compose -f docker-compose.prod.yml restart web

Stop and Start

# Stop all services
docker compose -f docker-compose.prod.yml down

# Start again
docker compose -f docker-compose.prod.yml --env-file .env.prod up -d

docker compose down -v will delete the MySQL volume and all panel data. Only use it on a fresh installation or when intentionally wiping all data.

On this page