FreshRSS/docs/en/admins/04_Updating.md

Backing Up and Updating FreshRSS

The following is general procedure; specific commands for Linux may be found here.

Backing Up

Before you update to a new version of FreshRSS, it's always a good idea to backup your current installation. Simply make an archive of your FreshRSS directory, which can be restored if needed by following the "Updating from a Zip Archive" section at the bottom of this document.

Updating From the Web

If you enabled web updates from your installation (see footnote 2 in installation), you can log into your admin account, select the update option under Administration in the Settings dropdown found on the top right of the webpage, and press the "Check for new updates" button. Alternatively, this page can be reached directly at http://<your_server>/i/?c=update.

This will check for and apply a new Stable version, if available.

Updating Using git

If you installed FreshRSS using git, you can update, change branches, or switch to a specific version from the command line.

Generally, the update procedure via git works as follows:

1. Making sure you're in your FreshRSS install directory, and fetch updates.
2. Checkout the branch you wish to use.
3. Perform a hard reset to discard local changes.
4. Delete manual additions. Be sure to move your backup out of the directory before doing this step!
5. Pull the new version.
6. Remove ./data/do-install.txt.
7. Re-set group read (and write, if you wish) permissions on all files in ., and group write permissions on ./data/.

Updating from a Zip Archive

Updating to a new version from a zip archive is always an option. Begin by unzipping the archive into your FreshRSS directory, overwriting old files, remove ./data/do-install.txt, and finally re-set group read (and write, if you wish) permissions on all files in . and group write permissions on ./data/.