Automatic Updates
SeqDesk includes a built-in update system accessible from the admin panel. The system checks for new versions, backs up the current installation, and applies updates with minimal downtime.
Update Flow
Check for updates
The admin UI at Admin → Settings shows the current version and checks for available updates. You can also force a check:
GET /api/admin/updates?force=trueThe check returns:
- Current installed version
- Running version
- Latest available version
- Whether a restart is required
- Whether an update is available
Disk space check
Before downloading, the system verifies at least 150 MB of free disk space for the update package and backup.
Download and verify
The update package is downloaded from the configured update server
(default: https://seqdesk.com) and its checksum is verified.
Automatic backup
Before applying, the system backs up the current installation to
.update-backup/:
| Backed Up | Description |
|---|---|
.next/ | Compiled application |
node_modules/ | Dependencies |
prisma/ | Database schema |
public/ | Static assets |
package.json | Dependency manifest |
Apply update
The new files are extracted and replace the current installation. Database migrations are run automatically.
Restart
The application restarts to load the new version. The update progress can be monitored at:
GET /api/admin/updates/progressUpdate Phases
| Phase | Description |
|---|---|
| Checking | Verifying available updates |
| Downloading | Downloading release package |
| Extracting | Extracting and applying files |
| Restarting | Application restart in progress |
| Complete | Update finished successfully |
| Error | Update failed (see error details) |
Update Lock
Only one update can run at a time. The system acquires an update lock to prevent concurrent updates.
Configuration
| Setting | Description |
|---|---|
SEQDESK_UPDATE_SERVER | Update server URL (default: https://seqdesk.com) |
Troubleshooting
If an update fails:
- Check the error phase and message in the update progress
- Verify disk space is sufficient
- Check network connectivity to the update server
- Use Manual Update & Rollback to restore from backup