Updating

Updating & Rollback

How to update Eclosion and roll back if needed.

Checking Your Version

Your current version is displayed in Settings at the bottom of the page. When updates are available, a banner appears at the top of the app with a link to view what's new.

Before Updating

Always backup your data before major updates.

Docker:

docker compose cp eclosion:/app/state ./backup-$(date +%Y%m%d)

Desktop: Your data is stored locally in the app's data directory. The app creates automatic backups during updates.

---

Desktop App

The desktop app checks for updates automatically on launch.

Automatic Updates

1. A notification appears: "Update available. Restart to install?"
2. Click to restart and apply the update
3. The app relaunches with the new version

Manual Check

You can also manually check for updates in the Settings menu.

---

Docker Self-Hosted

Using Pre-Built Images (Recommended)

docker compose pull
docker compose up -d

Building from Source

cd eclosion
git pull
docker compose up -d --build

---

Rollback to a Previous Version

If you need to revert to a specific version:

Docker

Edit docker-compose.yml to pin a version:

services:
  eclosion:
    image: ghcr.io/312-dev/eclosion:1.0.0

Then restart:

docker compose up -d

Desktop

1. Download the specific version from GitHub Releases
2. Uninstall the current version
3. Install the downloaded version
4. Disable auto-updates in Settings if you want to stay on that version

---

Release Channels

Channel	Tag Format	Use Case
Stable	v1.0.0	Production use
Beta	v1.1.0-beta.20240115.1	Testing new features

Beta releases are pre-releases and may have bugs. Use stable releases for production deployments.