Updating Cyrus Panel

Choose the update method that corresponds to how you originally installed Cyrus Panel.

---

Method 1: Release Archive Update (Recommended)

If you installed Cyrus Panel by downloading panel.zip from GitHub Releases:

1. Stop the Panel (e.g., stop your terminal session or pm2 stop cyrus / systemctl stop cyrus).
2. Backup your .env configuration file:

   cp .env ../cyrus.env.backup

3. Download the latest panel.zip:

   wget https://github.com/HasenDev/cyrus-panel/releases/latest/download/panel.zip

4. Remove old files (keep your .env intact):

   find . -mindepth 1 -not -name '.env' -not -name 'panel.zip' -delete

5. Extract the new release:

   unzip panel.zip
   rm panel.zip

6. Install any new dependencies and restart:

   npm install --omit=dev
   npm run start

---

Method 2: Source Installation Update (Git / Custom Builds)

If you cloned Cyrus Panel from source and build the frontend yourself:

1. Pull latest changes and update the frontend submodule:

   git pull
   git submodule update --init --recursive

2. Install updated dependencies:

   npm install

3. Rebuild the Next.js frontend:

   npm run build

4. Restart the panel:

   npm run start