Install Miniflux Inside Docker Container on Linux

Miniflux is an open-source, minimalist RSS feed reader designed to help users easily manage and read RSS and Atom feeds. It focuses on simplicity and speed with a lightweight user interface that's highly optimized for performance.

This tutorial explains how to install Miniflux inside a Docker container on Linux. Commands have been tested on Ubuntu.

Prepare environment

Make sure you have installed Docker in your system. If you are using Ubuntu, installation instructions can be found in the post.

You also need to have a running PostgreSQL container. Instructions can be found in the post.

Install Miniflux

Before starting, create miniflux database:

docker exec -it postgresql psql -U postgres -c "CREATE DATABASE miniflux"

• Host network

Run the following command to create a container for Miniflux that uses host network:

docker run -d --name=miniflux --restart=always --network=host \
    -e ADMIN_USERNAME=admin \
    -e ADMIN_PASSWORD=pwd123 \
    -e CREATE_ADMIN=1 \
    -e RUN_MIGRATIONS=1 \
    -e DATABASE_URL=postgres://postgres:pwd123@127.0.0.1/miniflux?sslmode=disable \
    miniflux/miniflux

PostgreSQL container should run on host network as well.

• User-defined bridge network

User-defined bridge network can be used for listening on different port. By default, Miniflux service is listening on port 8080. It can be changed with -p option.

docker network create app-net

docker run -d --name=miniflux --restart=always --network=app-net \
    -p 8081:8080 \
    -e ADMIN_USERNAME=admin \
    -e ADMIN_PASSWORD=pwd123 \
    -e CREATE_ADMIN=1 \
    -e RUN_MIGRATIONS=1 \
    -e DATABASE_URL=postgres://postgres:pwd123@postgresql/miniflux?sslmode=disable \
    miniflux/miniflux

PostgreSQL container should run on the same user-defined bridge network as well.

Notes:

• Don't forget to change admin password for Miniflux using ADMIN_PASSWORD.
• The DATABASE_URL can be used to define PostgreSQL connection parameters.

Testing Miniflux

Open a web browser and go to http://<IP_ADDRESS>:8080, where <IP_ADDRESS> is the IP address of the system. Log in to the dashboard with the admin username and password.

Uninstall Miniflux

To completely remove Miniflux, remove its container:

docker rm --force miniflux

Remove Miniflux image:

docker rmi miniflux/miniflux

If a user-defined bridge network was created, you can delete it as follows:

docker network rm app-net