{"id":149643,"date":"2024-12-26T15:28:37","date_gmt":"2024-12-26T15:28:37","guid":{"rendered":"https:\/\/linuxiac.com\/?p=149643"},"modified":"2024-12-26T15:36:22","modified_gmt":"2024-12-26T15:36:22","slug":"how-to-install-freshrss-rss-feed-aggregator-with-docker","status":"publish","type":"post","link":"https:\/\/linuxiac.com\/how-to-install-freshrss-rss-feed-aggregator-with-docker\/","title":{"rendered":"How to Install FreshRSS with Docker: A Step-by-Step Guide"},"content":{"rendered":"\n

Staying on top of the latest news, updates, and blog posts can feel overwhelming, especially when your favorite sources are scattered across the web. That\u2019s where FreshRSS comes in. It allows you to have all your news, updates, and articles from various websites neatly organized in one centralized place.<\/p>\n\n\n\n

FreshRSS<\/a> is a lightweight, open-source RSS feed aggregator written in PHP. And the best part? You can host it yourself, keeping your data private and fully under your control.<\/p>\n\n\n\n

That’s what exactly I show you in this article – how to install FreshRSS using Docker Compose. With just a few steps, you\u2019ll have your own self-hosted RSS feed aggregator up and running, ready to centralize and streamline your news feed experience.<\/p>\n\n\n\n

Prerequisites<\/h2>\n\n\n\n

Before proceeding with the installation, ensure you have Docker installed on your system.<\/p>\n\n\n\n

But if you don\u2019t have it, fear not; any of the following guides will help you get it quickly. Pick the distribution you are using in one of the following links: Ubuntu 24.04<\/a>, Debian 12<\/a>, Arch<\/a>, Alma\/Rocky<\/a>, Fedora<\/a>, Linux Mint 22<\/a>, Pop!_OS 22.04<\/a>, or Raspberry Pi OS<\/a>.<\/p>\n\n\n\n

The other essential component is Docker Compose. Recent Docker versions now include Docker Compose by installing the \u201cdocker-compose-plugin<\/em>\u201d package. So, install it if it\u2019s not already in your setup.<\/p>\n\n\n\n

As another option, you can also get it separately using both commands below. In that case, remember, when running the tool, to type docker-compose<\/code> instead of docker compose<\/code>.<\/p>\n\n\n

sudo curl -L \"https:\/\/github.com\/docker\/compose\/releases\/latest\/download\/docker-compose-linux-$(uname -m)<\/span>\"<\/span> -o \/usr\/local<\/span>\/bin\/docker-compose\nsudo chmod +x \/usr\/local<\/span>\/bin\/docker-compose<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n
Install FreshRSS with Docker Compose<\/h2>\n\n\n\n
The first step is to create the project directory in which our Docker Compose deployment file will be placed. Then switch to it; from here on, you need to execute all commands further down in this guide from that location.<\/p>\n\n\n
mkdir freshrss\ncd<\/span> freshrss<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n
Next, create a \u201cdocker-compose.yml<\/strong><\/em>\u201d file, like a blueprint for our Docker setup. This file will define the services, volumes, ports, etc., telling Docker Compose what to do and how to set up the FreshRSS container.<\/p>\n\n\n
nano docker-compose.yml<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n
services:\n  freshrss:\n    image: freshrss\/freshrss:latest\n    container_name: freshrss\n    environment:\n      TZ: America\/New_York\n      CRON_MIN: '*\/30'<\/span>\n    ports:\n      - 8080<\/span>:80<\/span>\n    volumes:\n      - .\/data:\/var\/www\/FreshRSS\/data\n      - .\/extensions:\/var\/www\/FreshRSS\/extensions\n    restart: unless-stopped<\/code><\/span>Code language:<\/span> Dockerfile<\/span> (<\/span>dockerfile<\/span>)<\/span><\/small><\/pre>\n\n\n
The second option, “CRON_MIN,” is more interesting. With this, you can use Cron (minutes<\/strong>) syntax to set specific intervals for FreshRSS to update its RSS feeds automatically. For example, by using ‘*\/30<\/em>,’ you\u2019re telling it to update every 30 minutes. Of course, you can customize this to suit your needs.<\/p>\n\n\n\n
For instance, a value like ‘15,45<\/em>‘ means the updates will happen twice an hour\u2014once at 15 minutes past the hour and again at 45 minutes past. You get the idea. To learn more about Cron syntax, check out our detailed guide<\/a>.<\/p>\n\n\n\n
Finally, we create two subdirectories\u2014”data<\/em>” and “extensions<\/em>“\u2014in the current directory. These ensure data persistence for our FreshRSS container, including saved settings and any extensions we might install later.<\/p>\n\n\n\n
Save the changes and run the container in the background (detached mode):<\/p>\n\n\n
docker compose up -d<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n
\"Deploying<\/a>
Deploying FreshRSS feed aggregator with Docker Compose.<\/figcaption><\/figure>\n\n\n\n
So far, so good. Now, let\u2019s move to the most exciting part. Open your browser and navigate to \u201chttp:\/\/localhost:8080<\/em><\/strong>\u201d (if you access FreshRSS from the same host) or \u201chttp:\/\/<server-ip-address>:8080<\/em><\/strong>\u201c (if you access it remotely). Of course, replace the \u201c<server-ip-address><\/em>\u201d part with your actual server\u2019s IP address.<\/p>\n\n\n\n
If, for some reason, something goes wrong, you can easily figure out what happened by checking the container log with this simple Docker command:<\/p>\n\n\n
docker logs freshrss<\/code><\/span>Code language:<\/span> Bash<\/span> (<\/span>bash<\/span>)<\/span><\/small><\/pre>\n\n\n
When accessing FreshRSS for the first time, you\u2019ll be prompted to do some initial configurations. Select the default language, then click the “Submit<\/em>” button to confirm your choice.<\/p>\n\n\n\n
\"Set<\/a>
Set default language.<\/figcaption><\/figure>\n\n\n\n
In the next step, “Checks<\/em>,” everything should appear green. Once confirmed, click the “Go to the next step<\/em>” button to proceed.<\/p>\n\n\n\n
\"Check<\/a>
Check if all required PHP modules are available.<\/figcaption><\/figure>\n\n\n\n
Set up the database that FreshRSS will use as its backend. While you can choose MySQL\/MariaDB or PostgreSQL, I strongly recommend sticking with the default choice, SQLite. It’s more than capable and provides excellent performance, keeping the software running quickly.<\/p>\n\n\n\n
\"Configure<\/a>
Configure the backend.<\/figcaption><\/figure>\n\n\n\n
Finally, set up the default user by choosing a username and password. This user will automatically have administrative rights. Once done, click the “Submit<\/em>” button to complete the process.<\/p>\n\n\n\n
\"Create<\/a>
Create an admin user.<\/figcaption><\/figure>\n\n\n\n
That’s it! Click “Complete installation<\/em>“.<\/p>\n\n\n\n
\"Complete<\/a>
Complete the FreshRSS installation.<\/figcaption><\/figure>\n\n\n\n
You\u2019ll be automatically redirected to the login screen. Use the credentials for the user you just created, and once you log in successfully, you\u2019ll be greeted by the default FreshRSS web UI.<\/p>\n\n\n\n
\"FreshRSS<\/a>
FreshRSS feed aggregator has been installed successfully.<\/figcaption><\/figure>\n\n\n\n
You can customize additional settings by clicking the gear icon in the top-right corner of FreshRSS.<\/p>\n\n\n\n
\"FreshRSS<\/a>
FreshRSS self-hosted feed aggregator.<\/figcaption><\/figure>\n\n\n\n
Add News Source to FreshRSS<\/h2>\n\n\n\n
Here\u2019s how to add your favorite news sources to the FreshRSS news aggregator. First, let\u2019s create a category. Click the “+<\/em>” icon next to the “Subscription Management<\/em>” button. Then, in the “Add a Category<\/em>” section, type in a name for your category\u2014for example, “Linux News<\/em>“\u2014and click the “Add<\/em>” button to confirm.<\/p>\n\n\n\n
\"Adding<\/a>
Adding a category.<\/figcaption><\/figure>\n\n\n\n
\"Adding<\/a>
Adding a category.<\/figcaption><\/figure>\n\n\n\n
Now, let\u2019s add our first news source! Go to the \u201cAdd a feed or category<\/em>\u201d menu. Under the \u201cAdd a feed<\/em>\u201d section, type the RSS feed URL (e.g., https:\/\/linuxiac.com\/feed\/<\/em>) into the \u201cFeed URL<\/em>\u201d field. Then, choose a category from the \u201cCategory<\/em>\u201d dropdown, and finally, click the \u201cAdd<\/em>\u201d button to confirm.<\/span><\/p>\n\n\n\n
\"Add<\/a>
Add news source to FreshRSS.<\/figcaption><\/figure>\n\n\n\n
This next gives you a quick summary of the news source you\u2019ve added. Just click “Submit<\/em>” to confirm.<\/p>\n\n\n\n
\"Add<\/a>
Add news source to FreshRSS.<\/figcaption><\/figure>\n\n\n\n
It\u2019s annoying, but a new window will pop up with an updated settings overview where you can make additional fine-tuned adjustments. Feel free to ignore it and click on the FreshRSS logo in the top left corner to return to the home screen.<\/p>\n\n\n\n
\"Add<\/a>
Add news source to FreshRSS.<\/figcaption><\/figure>\n\n\n\n
Your new news feed has been successfully added to the FreshRSS feed aggregator. You can follow the same steps to add any other news source you’d like to stay updated whenever new content is published.<\/p>\n\n\n\n
\"FreshRSS<\/a>
FreshRSS self-hosted feed aggregator.<\/figcaption><\/figure>\n\n\n\n
Conclusion<\/h2>\n\n\n\n
That’s all friends! In this guide, I showed you how to install and set up FreshRSS with Docker, bringing you closer to a streamlined, self-hosted RSS feed experience.<\/p>\n\n\n\n
By centralizing your favorite news sources, you can now enjoy staying informed in a way tailored to your preferences\u2014right from the comfort of your own server.<\/p>\n\n\n\n
For more detailed information about FreshRSS, visit the project\u2019s website<\/a>. In addition, I strongly recommend checking out the official documentation<\/a> or visiting the project’s GitHub page<\/a>.<\/p>\n\n\n\n
I hope this guide was helpful and made the process straightforward for you. If you have any questions or feedback, feel free to reach out in the comment section below.<\/p>\n","protected":false},"excerpt":{"rendered":"
Learn how to install FreshRSS, a self-hosted RSS feed aggregator, with Docker in just a few easy steps and centralize your news feed experience.<\/p>\n","protected":false},"author":10,"featured_media":149646,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[9,4417],"tags":[6225,5194],"class_list":["post-149643","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorials","category-linux-knowledge","tag-freshrss","tag-rss"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/posts\/149643","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/comments?post=149643"}],"version-history":[{"count":0,"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/posts\/149643\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/media\/149646"}],"wp:attachment":[{"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/media?parent=149643"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/categories?post=149643"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/linuxiac.com\/wp-json\/wp\/v2\/tags?post=149643"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
As you can see, it’s a simple deployment. We configure two main settings in the “environment<\/em>” section. The first setting is for the time zone. Make sure to update it to match your local one. You can find a complete list of available time zones here<\/a>.<\/p>\n\n\n\n