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

Updating

This is the general procedure; for specific Linux commands, see Updating on Linux.

ℹ️ Update version by version (e.g. from 1.26.0, go to 1.27.1 before 1.28.1) and verify FreshRSS runs after each step. The web interface walks this path automatically; with git or a zip archive, pick intermediate versions yourself.

Backing up

Before updating, back up:

• ./data/
• ./extensions/ if you use third-party extensions
• ./i/themes/ if you have custom themes
• Your database, if using MySQL, MariaDB, or PostgreSQL

See the Backup page for the full list and procedures.

Using the web interface

Web updates require group write permissions on the FreshRSS source folder.

Log in as admin, open the Settings menu (top right), choose Administration, then Update, and press "Check for new updates". The page is also reachable at http://<your_server>/i/?c=update. This will check for and apply a new stable version, if available.

Using git

Use git to update, change branches, or switch to a specific version from the command line.

⚠️ Make sure your backup is outside the FreshRSS directory before starting.

1. Change to your FreshRSS install directory and fetch updates.
2. Checkout the branch or tag you wish to use (tags like 1.27.1 pin specific versions).
3. Perform a hard reset to discard local changes.
4. Delete files not tracked by git.
5. Pull the new version.
6. Re-apply file ownership and permissions.

Using a zip archive

Updating from a zip archive works for any source installation.

1. Download the latest stable or rolling release and extract it (for a specific version, use the releases page). The archive contains a top-level FreshRSS-X.Y.Z/ folder.
2. Copy the extracted contents into your FreshRSS directory, overwriting existing files. Your user data, extensions, and custom themes are preserved.
3. Re-apply file ownership and permissions.

Note that overwriting does not remove files that were deleted in newer releases; this is rarely a problem in practice.

Using Docker

If you run FreshRSS in Docker, see How to update in the Docker README.