Installation Tutorials

Here are a couple of tutorials to help you to install Miniflux (They are only examples).

Installing Miniflux on your own server

Ubuntu 16.04

  • Install Postgresql: apt install postgresql
  • Prepare the database:
# Switch to the postgres user
$ su - postgres

# Create a database user for Miniflux
$ createuser -P miniflux
Enter password for new role: ******
Enter it again: ******

# Create a database for miniflux that belongs to our user
$ createdb -O miniflux miniflux

# Create the extension hstore as superuser
$ psql miniflux -c 'create extension hstore'
  • Install Miniflux:
# Download the latest Debian package from the release page
# In this example, this is the version 2.0.13
$ wget

# Install the package
$ dpkg -i miniflux_2.0.13_amd64.deb

# Run the SQL migrations
$ export DATABASE_URL=postgres://miniflux:[email protected]/miniflux?sslmode=disable
$ miniflux -migrate
Current schema version: 0
Latest schema version: 16
Migrating to version: 1
Migrating to version: 2
Migrating to version: 3

# Create the first user
$ miniflux -create-admin
Enter Username: superman
Enter Password: ******

# Update the config file /etc/miniflux.conf
# Add/Edit this lines:
# DATABASE_URL=postgres://miniflux:[email protected]/miniflux?sslmode=disable
$ vim /etc/miniflux.conf

# Authorize Miniflux to listen on port 80
$ setcap cap_net_bind_service=+ep /usr/bin/miniflux

# Restart the process to take the new config values into consideration
systemctl restart miniflux

# Check the logs to make sure the process is running properly
$ journalctl -u miniflux
[INFO] Starting Miniflux...
[INFO] [Worker] #0 started
[INFO] [Worker] #1 started
[INFO] [Worker] #2 started
[INFO] [Worker] #3 started
[INFO] Listening on "" without TLS
  • Now, you can access to your Miniflux instance via http://your-server/

Fedora 28

Database installation and configuration:

  1. Install Postgresql: sudo dnf install -y postgresql-server postgresql-contrib
  2. Enable Postgres service: sudo systemctl enable postgresql
  3. Initialize the database: sudo postgresql-setup --initdb --unit postgresql
  4. Start Postgres service: sudo systemctl start postgresql
  5. Create Miniflux database user: sudo su - postgres and createuser -P miniflux
  6. Create Miniflux database: createdb -O miniflux miniflux
  7. Create HSTORE extension: psql miniflux -c 'create extension hstore'


More information available on the Fedora Wiki.

Miniflux installation:

  • Install RPM package:
sudo dnf install
  • Run SQL migrations and create first user:
export DATABASE_URL=postgres://miniflux:[email protected]/miniflux?sslmode=disable

# Create database structure:
miniflux -migrate

# Create frist user:
miniflux -create-admin
  • Start the service:
systemctl enable miniflux
systemctl start miniflux

# To watch the logs:
journalctl -f -u miniflux
  • Access your Miniflux instance via http://your-server:8080/

Running Miniflux with Docker Compose

You could use Docker to try quickly Miniflux on your local machine:

Create a docker-compose.yml file into a folder called miniflux for example.

version: '3'
    image: miniflux/miniflux:latest
      - "80:8080"
      - db
      - DATABASE_URL=postgres://miniflux:[email protected]/miniflux?sslmode=disable
      - CREATE_ADMIN=1
      - ADMIN_USERNAME=admin
      - ADMIN_PASSWORD=test123
    image: postgres:10.1
      - POSTGRES_USER=miniflux
      - POSTGRES_PASSWORD=secret
      - miniflux-db:/var/lib/postgresql/data

Then run docker-compose up and go to http://localhost/.

After the first user has been created, you should remove the variables CREATE_ADMIN, ADMIN_USERNAME and ADMIN_PASSWORD.

Deploying Miniflux on Heroku

Since the version 2.0.6, you can deploy Miniflux on Heroku in few seconds.

  • Clone the repository on your machine: git clone
  • Switch to a stable version, for example git checkout 2.0.13 (master is the development branch)
  • Create a new Heroku application: heroku apps:create
  • Add the Postgresql addon: heroku addons:create heroku-postgresql:hobby-dev
  • Add environment variables to setup the application:
# This parameter will create all tables in the database.
heroku config:set RUN_MIGRATIONS=1

# The following parameters will create the first user.
heroku config:set CREATE_ADMIN=1
heroku config:set ADMIN_USERNAME=admin
heroku config:set ADMIN_PASSWORD=test123
  • Deploy the application on Heroku: git push heroku master
  • After the application is installed successfully, you don’t need these variables anymore:
heroku config:unset CREATE_ADMIN
heroku config:unset ADMIN_USERNAME
heroku config:unset ADMIN_PASSWORD
  • To watch the logs, use heroku logs.
  • You can also run a one-off container to run the commands manually: heroku run bash. The Miniflux binary will be located into the folder bin.
  • To update Miniflux, pull the new version from the repository and push to Heroku again.

Deploying Miniflux on Google App Engine

  • Create a Postgresql instance via Google Cloud SQL, then create a user and a new database
  • Clone the repository and create a app.yaml file in the project root directory
runtime: go111
    CLOUDSQL_USER: replace-me
    CLOUDSQL_PASSWORD: top-secret

    ADMIN_USERNAME: foobar
    ADMIN_PASSWORD: test123
    DATABASE_URL: "user=replace-me password=top-secret host=/cloudsql/INSTANCE_CONNECTION_NAME dbname=miniflux"
  • Last step, deploy your application: gcloud app deploy

Replace the values according to your project configuration. The database connection is made over a Unix socket on App Engine.

Refer to Google Cloud documentation for more details:


Running Miniflux on Google App Engine should work but it’s considered experimental.

Deploying Miniflux on AlwaysData

AlwaysData is a French shared hosting provider. You can install Miniflux in few minutes on their platform.

  • Open an account
  • Via the admin panel, create a Postgresql database and define a user/password
  • Create a website, choose “User Program”, use a custom shell-script, for example ~/
  • Enable the SSH access and open a session ssh
  • Install Miniflux:
mv miniflux-linux-amd64 miniflux
chmod +x miniflux
  • Create a shell script to start miniflux, let’s call it

export DATABASE_URL=" dbname=xxxx user=xxxx password=xxx sslmode=disable"

env --unset PORT ~/miniflux
  • Make the script executable: chmod +x
  • Run the db migrations and a create the first user:
export DATABASE_URL=".... replace me...."
./miniflux -migrate
./miniflux -create-admin
  • Go to

Via the admin panel, in Advanced > Processes, you can even see the Miniflux process running: