Software Updates
Keep your CeyMail dashboard up to date with one-click updates, automatic backups, and rollback on failure.
Software Updates let you check for and install new versions of CeyMail directly from the dashboard. Updates include an automatic backup before applying changes and will roll back automatically if anything goes wrong.
Pro feature
Feature updates are available on the Pro plan and above. Security patches are always available regardless of your plan.
Checking for updates
Navigate to Settings > About to see your current version and check for updates. Click Check Now to query the update server for the latest release. The dashboard caches the result and shows:
- Current version -- the version you're running
- Latest version -- the newest available release
- Update type -- major, minor, or patch (color-coded badge)
- Security patch -- flagged separately if the update includes a security fix
- What's New -- a preview of what changed in the release
- Release date -- when the update was published
If you're already on the latest version, you'll see a confirmation with the time of the last check.
Installing an update
When an update is available, click Update Now to start the process. A progress modal tracks each step in real time:
| Step | Description |
|---|---|
| 1. Pre-flight checks | Verifies the system is ready to update |
| 2. Version check | Confirms the target version |
| 3. Database backup | Backs up your databases before any changes |
| 4. Configuration backup | Backs up configuration files |
| 5. Download | Downloads the new release |
| 6. Deploy | Applies the update to your system |
| 7. Restart services | Restarts CeyMail services with the new version |
| 8. Verify | Confirms the update was successful |
Each step shows a progress indicator (pending, in progress, or completed) with real-time status messages.
Don't close the browser
Keep the browser tab open while the update is running. The modal tracks progress in real time and will notify you when the update completes or if it fails.
Automatic backup
Before applying any update, CeyMail automatically backs up your databases and configuration. If the update fails, these backups are used for rollback. The backup path is displayed in the progress modal so you know exactly where your data is saved.
Automatic rollback
If any step in the update process fails, CeyMail automatically rolls back to your previous version using the pre-update backup. The progress modal shows the rollback status and the error that triggered it. Your mail server continues running on the previous version with no interruption.
Security patches
Security patches bypass the license gate -- they're available to all plans, not just Pro. When a security patch is available, it's highlighted with a dedicated badge so you can prioritize installing it.
Update gating
If your license doesn't include feature updates (Free plan), the update section shows the available version and changelog but the Update Now button is replaced with an Upgrade Plan prompt. Security patches remain installable regardless of plan.