Manage your installation

Routine commands

Run your platform's executable from the bundle folder. Keep any custom --state-root path printed by setup.

.\backloggo-setup-windows-amd64.exe status

./backloggo-setup-darwin-arm64 status

./backloggo-setup status

Add these subcommands after that executable:

Updates and rollback

Finish active work first. Use the target release's verified bundle and your saved installation location.

.\backloggo-setup-windows-amd64.exe upgrade --release VERSION

./backloggo-setup-darwin-arm64 upgrade --release VERSION

./backloggo-setup upgrade --release VERSION

Replace VERSION with the published version. Upgrade preserves settings and saves a database copy before migration. If it fails, check status and follow the reported recovery action.

.\backloggo-setup-windows-amd64.exe rollback

./backloggo-setup-darwin-arm64 rollback

./backloggo-setup rollback

Backups

Your database, credentials and license are stored outside the application container. They remain in place when you update BacklogGo.

There is no automatic backup service. Stop BacklogGo, then back up its persistent storage: database and project data, provider credentials, Codex login state, and licenses. Keep the matching image identity and saved setup files, and verify the backup.

Restore with the matching runtime into empty destination storage. Keep the original stopped so two copies cannot act on the same board. Deleting the database or recreating storage is not a repair.

Buy a license

Already using the free version? Choose a plan, then enter your installation ID when asked.

Run this on the machine where BacklogGo is running. Copy installation_id from the result into the purchase form:

Use your installation's address. The examples use the default port, 8787. If yours differs, use the Local API address printed by status and keep /api/license.

Invoke-RestMethod -Method Get -Uri "http://127.0.0.1:8787/api/license"

curl --fail-with-body "http://127.0.0.1:8787/api/license"

curl --fail-with-body "http://127.0.0.1:8787/api/license"

After purchase, download the file and install your license. After each successful renewal, download the renewed file from your website account and replace it in the same location.

Install a license file

After purchase, download your signed license file as backloggo.license.

Copy the downloaded file into your installation's persistent license volume, named backloggo-mvp-v1-license by default. The copy command below uses the stable internal filename shared with older releases, so upgrades and rollback keep the same license.

Existing installations keep their original volume name. Find the setting ending in LICENSE_VOLUME in setup/settings.json under the Data folder printed by status.

Finish active work, then stop your installation:

.\backloggo-setup-windows-amd64.exe stop

./backloggo-setup-darwin-arm64 stop

./backloggo-setup stop

Copy the file to that license volume using the command below. To renew or change plans, replace the file in the same location. Your license and database storage stay in place when upgrading.

docker ps -a --filter "volume=backloggo-mvp-v1-license" --filter "label=com.docker.compose.service=agent-run" --format "{{.Names}}"

docker cp .\backloggo.license CONTAINER_NAME:/run/agent-run/license/agent-run.license

chmod 644 ./backloggo.license
docker cp ./backloggo.license CONTAINER_NAME:/run/agent-run/license/agent-run.license

chmod 644 ./backloggo.license
docker cp ./backloggo.license CONTAINER_NAME:/run/agent-run/license/agent-run.license

Start the installation again:

.\backloggo-setup-windows-amd64.exe start

./backloggo-setup-darwin-arm64 start

./backloggo-setup start

Run the license status command again.

Confirm that state is valid or expiring and capacity_limit matches your plan. If not, follow next_action or ask for help. Keep license files out of public reports.

See Models and licenses for free capacity and offline verification.