Skip to main content

​
orphelix update

Update Orphelix to the latest version from GitHub with automatic backup.

​
Usage

orphelix update

​
Interactive Update Process

$ orphelix update

🔍 Checking for updates...

📦 New version available: v1.3.0 (current: v1.2.3)

Release Notes:
  - Added resource optimization recommendations
  - Improved metrics collection
  - Fixed notification worker crash
  - Enhanced UI performance

View full changelog: https://github.com/corapoid/orphelix/releases/tag/v1.3.0

   Update now? [y/N]: y

💾 Creating backup before update...
✅ Backup created: ~/orphelix-backups/orphelix-backup-2025-11-26-103045.db

📥 Downloading update...
[████████████████████] 100%

✅ Update complete!
   Version: v1.2.3 → v1.3.0

   Restart Orphelix with: orphelix restart

​
Automatic Backup

Before updating, a full database backup is automatically created. If the update fails, you can restore from this backup.

​
Update Source

Updates are fetched from GitHub releases: 
https://github.com/corapoid/orphelix/releases/latest

​
Version Checking

The update command:
  1. Queries GitHub API for latest release
  2. Compares with current version (from package.json)
  3. Shows release notes if update available
  4. Prompts for confirmation
  5. Creates automatic backup
  6. Downloads and installs update
  7. Preserves all settings and data

​
No Update Available

$ orphelix update

🔍 Checking for updates...

✅ You are already running the latest version (v1.3.0)

​
Skipping Update

Press N or Ctrl+C to cancel: 
Update now? [y/N]: n
⏭️  Update cancelled

​
After Update

Restart the application to use the new version: 
orphelix restart

​
Rollback

If the update causes issues, restore from the automatic backup: 
# Find the pre-update backup
orphelix restore ~/orphelix-backups/orphelix-backup-2025-11-26-103045.db

# Reinstall previous version
git clone https://github.com/corapoid/orphelix.git && cd orphelix/app@1.2.3

# Restart
orphelix restart

​
Update Frequency

Check for updates:
  • Automatically when running orphelix version
  • Manually with orphelix update
  • Weekly via GitHub notifications (if watching the repository)

​
Pre-release Updates

The update command installs stable releases only. Pre-release versions must be installed manually via npm.
To install pre-release: 
git clone https://github.com/corapoid/orphelix.git && cd orphelix/app@next

​
Troubleshooting

​
Network Error

Error: Failed to fetch updates from GitHub
Check internet connection and try again.

​
Permission Denied

Error: EACCES: permission denied
Update npm permissions or use: 
sudo git clone https://github.com/corapoid/orphelix.git && cd orphelix/app
(Not recommended - fix npm permissions instead)

​
Update Failed

If update fails:
  1. Restore from automatic backup
  2. Check logs: orphelix logs
  3. Run diagnostics: orphelix doctor
  4. Report issue on GitHub

​
See Also

Changelog

View all version history

Releases

Browse GitHub releases