Dockerfile for FreshRSS
This file is destined to configure a virtual environment for FreshRSS. It is
based on Centos 6.
Please note it is only for developers or testing! It is assumed you know Docker and you have already installed it on your computer. If it's not the case, please refer to the official website.
If you have any trouble using this image and if the answer is NOT in this document, feel free to contact me at
In 3 steps:
$ docker pull marienfressinaud/freshrss $ git clone https://github.com/marienfressinaud/FreshRSS.git FreshRSS $ docker run -t -i -v /path/to/FreshRSS:/var/www/html -p 8080:80 marienfressinaud/freshrss
In case of trouble, please refer to the rest of this document.
Get the FreshRSS image
First get the Docker image on your PC:
$ docker pull marienfressinaud/freshrss
Or if you prefer to build it yourself:
$ git clone https://github.com/marienfressinaud/docker-freshrss.git docker-freshrss $ docker build -t marienfressinaud/freshrss docker-freshrss
Note that the image does NOT include FreshRSS source code! You should first get the code
$ git clone https://github.com/marienfressinaud/FreshRSS.git FreshRSS
Run a FreshRSS container
To use FreshRSS image, you should run it and mount your local FreshRSS
directory in the corresponding running container. Do not forget to map port
8080 (or any other) to port
$ docker run -t -i -v /path/to/FreshRSS:/var/www/html -p 8080:80 marienfressinaud/freshrss
Now, you have access to a shell where you can do whatever you want (you have a
root access!). In a basic usage, you should not need this shell. Just
keep it open and read the next section :)
- apache UID is 1000 and GID is 100. Note that you can have to change these
values to match with the owner of source code. To do that:
usermod -u NEW_UID -g NEW_GID apache
- Credentials for the MySQL database:
- You have access to FreshRSS source code in
/var/www/html(be careful, if you
change it, it is changed on the host OS too)
- If you want to install new packages, remember you use a CentOS:
yum installcommand is your friend…
Last step is to install FreshRSS. Don't worry, you will not have to do that
- Open a web browser on 127.0.0.1:8080
- Follow the different steps. Only information for database matter:
- Once FreshRSS is installed, enjoy!
Changes about feeds (e.g. adding a feed, refresh items) are not saved when
the container is stopped!
Configure an alias
The command line to start FreshRSS container is a bit long. You can add an alias in
alias start-freshrss='docker run -t -i -v /path/to/FreshRSS:/var/www/html -p 8080:80 marienfressinaud/freshrss'
Remember to reload
~/.bashrc information with
Keep container in background
You may have no need of a shell. You can change
-t argument by
alias start-freshrss='docker run -d -i -v /path/to/FreshRSS:/var/www/html -p 8080:80 marienfressinaud/freshrss'
Fresh install and i get: Damn! Check permissions on ./data directory. HTTP server must have rights to write into
any help, on how to solve this problem.