Auto-Update
Keep Xermius current with automatic updates—get new features, bug fixes, and security patches seamlessly.
How Auto-Update Works
Simple explanation:
1. Xermius checks for updates (background)
2. New version available? Download it
3. Notify you update is ready
4. Restart to install
5. Done! Running latest version
Update Settings
Access:
Settings → Updates
or
Menu → Check for Updates
Auto-Update Configuration
┌────────────────────────────────────┐
│ Updates │
├────────────────────────────────────┤
│ Automatic Updates: │
│ [✓] Automatically download updates │
│ [✓] Install updates automatically │
│ │
│ Update Channel: │
│ ● Stable (recommended) │
│ ○ Beta (early access) │
│ │
│ Check Frequency: │
│ ● Daily │
│ ○ Weekly │
│ ○ Manual only │
│ │
│ Current Version: 2.1.0 │
│ Last Check: 2 hours ago │
│ Status: Up to date ✓ │
│ │
│ [Check Now] [View Update History] │
└────────────────────────────────────┘
Update Channels
Stable Channel (Recommended)
Type: Production releases
Frequency: Monthly
Testing: Thoroughly tested
Risk: Minimal
Stability: Excellent
For:
✓ All users
✓ Production use
✓ Stability priority
✓ Default choice
Beta Channel
Type: Pre-release builds
Frequency: Weekly
Testing: Limited
Risk: Higher
Stability: Good
For:
○ Early adopters
○ Test new features
○ Provide feedback
○ Risk-tolerant users
Not for production!
Update Process
Automatic Update
Background download:
1. Xermius checks (daily)
"New version available: 2.2.0"
2. Download starts (background)
Progress: 0% → 100%
No interruption to work
3. Download complete
Notification appears:
"Update ready! Restart to install"
4. Restart when ready
Click "Restart" or later
5. Update installs
Takes 10-30 seconds
6. Xermius opens
"Updated to 2.2.0!" ✓
Notification:
┌────────────────────────────────────┐
│ 🔔 Update Ready │
├────────────────────────────────────┤
│ Xermius 2.2.0 is ready to install │
│ │
│ What's New: │
│ • New terminal features │
│ • Performance improvements │
│ • Bug fixes │
│ │
│ [View Release Notes] │
│ │
│ [Later] [Restart & Install] │
└────────────────────────────────────┘
Manual Update
Check manually:
Settings → Updates → Check Now
Checking for updates...
⌛ Please wait
Result:
✓ New version available: 2.2.0
[Download] [View Changes]
or
✓ You're up to date! (2.1.0)
No update needed
Update Options
Postpone Update
Delay installation:
Update ready notification:
[Later]
Reminds again:
- In 1 hour
- Tomorrow
- In 3 days
Update stays downloaded
Install when convenient
Auto-Install
Install automatically:
Settings → Updates
[✓] Install updates automatically
When enabled:
- Downloads in background
- Installs on next restart
- No notification if idle
- Seamless experience
When disabled:
- Downloads in background
- Prompts before install
- You choose when
Update Schedule
Preferred time:
Install During:
● Off-hours (2 AM - 6 AM)
○ At shutdown
○ Immediately when available
○ Ask every time
[✓] Only when idle for 10+ minutes
[✓] Skip if connections active
[Save]
Release Notes
View What's New
Release notes:
Xermius 2.2.0 - January 15, 2024
🎉 New Features:
• Terminal tabs - Work with multiple terminals
• Snippet variables - Dynamic command templates
• SFTP resume - Resume interrupted transfers
• Dark mode improvements
⚡ Improvements:
• 40% faster connection times
• Reduced memory usage
• Better error messages
• Improved stability
🐛 Bug Fixes:
• Fixed terminal scrolling issue
• Fixed SFTP upload error
• Fixed sync conflict resolution
• Fixed notification sounds
🔒 Security:
• Updated dependencies
• Enhanced encryption
• Fixed authentication bug
[Download Update] [Full Changelog]
Update History
Past updates:
┌────────────────────────────────────┐
│ Update History │
├────────────────────────────────────┤
│ 2.2.0 - Jan 15, 2024 │
│ ✓ Installed successfully │
│ [View Release Notes] │
│ │
│ 2.1.0 - Dec 10, 2023 │
│ ✓ Installed successfully │
│ [View Release Notes] │
│ │
│ 2.0.5 - Nov 20, 2023 │
│ ✓ Installed successfully │
│ [View Release Notes] │
│ │
│ 2.0.0 - Oct 1, 2023 │
│ ✓ Installed successfully │
│ [View Release Notes] │
└────────────────────────────────────┘
[Export History]
Update Notifications
Configure Alerts
Update Notifications:
[✓] Notify when update available
[✓] Notify when download complete
[✓] Show release notes
[ ] Show beta updates
Notification Type:
● Desktop notification
○ In-app only
○ Email
[Save]
Notification Examples
Update available:
🔔 Xermius Update Available
Version 2.2.0 is now available
Click to view changes
Download complete:
✓ Update Downloaded
Xermius 2.2.0 ready to install
Restart when convenient
Installed:
✅ Updated Successfully
Now running Xermius 2.2.0
Check out what's new!
Troubleshooting
Update Failed
Common issues:
Error: "Update download failed"
Cause: Network issue
Fix: Check internet, try again
Error: "Update installation failed"
Cause: Permissions or disk space
Fix: Check permissions, free space
Error: "Update corrupted"
Cause: Incomplete download
Fix: Delete and re-download
Manual fix:
1. Settings → Updates
2. Clear update cache
3. Check Now
4. Download fresh copy
5. Install
Update Stuck
If frozen:
1. Wait 5 minutes
2. Still stuck?
- Restart Xermius
- Check available first
3. Still issues?
- Download from website
- Install manually
Can't Check for Updates
Verify:
1. Internet connected?
ping update.xermius.com
2. Firewall blocking?
Allow Xermius network access
3. Proxy settings?
Configure in Settings → Network
4. Certificate issue?
Check system date/time
Old Version Warning
If behind:
⚠️ Update Required
You're running: 1.5.0
Current: 2.2.0
Behind: 7 versions
Reasons to update:
- Security fixes
- Bug fixes
- New features
- Better performance
[Update Now]
Manual Update
Download from Website
If auto-update fails:
1. Visit: xermius.com/download
2. Download installer:
macOS: Xermius-2.2.0.dmg
Windows: Xermius-2.2.0.exe
Linux: xermius-2.2.0.AppImage
3. Run installer
4. Overwrites old version
5. Settings/data preserved
Verify Installation
After update:
Menu → About Xermius
Version: 2.2.0 ✓
Build: 2024-01-15
Channel: Stable
[Check for Updates]
Advanced Options
Beta Testing
Join beta program:
Settings → Updates → Update Channel
○ Stable → ● Beta
[✓] I understand beta risks:
- May have bugs
- Less stable
- For testing only
[Enable Beta Updates]
Next: Checks for beta releases
Get features weeks early!
Update Cache
Clear cache:
Settings → Updates → Advanced
Update Cache:
Location: ~/Library/Caches/Xermius/
Size: 125 MB
[Clear Cache]
Frees disk space
Re-downloads on next update
Rollback
Revert to previous:
If new version has issues:
Menu → Help → Rollback Update
Available Versions:
● 2.2.0 (current)
○ 2.1.0 (previous)
○ 2.0.5
[Rollback to 2.1.0]
Note: Data compatible
No settings lost
Best Practices
1. Keep Auto-Update Enabled
Recommended:
[✓] Automatically download
[✓] Automatically install
Benefits:
- Always secure
- Latest features
- Bug fixes
- No manual work
2. Read Release Notes
Before/after update:
□ Check what's new
□ Read known issues
□ Test new features
□ Report bugs
Stay informed!
3. Update Regularly
Check monthly:
□ Current version?
□ Updates available?
□ Release notes reviewed?
Don't skip versions!
4. Test After Update
After updating:
□ Test connections
□ Verify settings
□ Check SSH keys
□ Test key features
Ensure everything works
5. Backup Before Major Updates
Before major version (2.0 → 3.0):
1. Export hosts
2. Export settings
3. Backup SSH keys
4. Then update
Safety first!
Update Schedule
Typical Release Cycle
Major Releases (X.0):
- Frequency: Yearly
- Example: 2.0 → 3.0
- Contains: Major features
Minor Releases (X.Y):
- Frequency: Monthly
- Example: 2.1 → 2.2
- Contains: Features + fixes
Patch Releases (X.Y.Z):
- Frequency: As needed
- Example: 2.1.0 → 2.1.1
- Contains: Bug fixes only
Security Updates
Critical security fixes:
- Released immediately
- Auto-installed (even if disabled)
- Notification sent
Should never skip!
FAQs
Q: Will update delete my data?
A: No! All preserved:
✓ Hosts
✓ Settings
✓ SSH keys
✓ Snippets
✓ Everything
Update only replaces app
Q: How long does update take?
A: Usually quick:
Download: 2-5 minutes
Install: 10-30 seconds
Total: < 5 minutes
Won't interrupt work!
Q: Can I skip updates?
A: Not recommended
Reasons:
- Security vulnerabilities
- Missing bug fixes
- Compatibility issues
- No new features
But you can postpone!
Q: Beta vs Stable?
A: Use Stable unless:
- You want to test
- Need specific feature
- Comfortable with bugs
- Can report issues
Otherwise: Stay on Stable
Next Steps
- ⚙️ Settings - Configure Xermius
- 🔔 Notifications - Update alerts
- 🔐 Security - Security updates
- 💡 What's New - Version history