Debian Installation

You must have Debian >= 8 or Ubuntu >= 16.04.

When using the Debian package, the Noflux daemon is supervised by systemd.

Make sure to install and configure Postgresql before installing Noflux.

Install Noflux with the Debian package

  1. Download the Debian package from the GitHub Releases page.
  2. Install the Debian package: dpkg -i noflux_2.0.13_amd64.deb

Install Noflux from the APT Repository

You can configure APT to use Noflux repository. To start, create a noflux.list file in the /etc/apt/sources.list.d directory. You will need sudo access to make these changes:

Here is a basic template for /etc/apt/sources.list.d/noflux.list:

deb [trusted=yes] https://repo.noflux.app/apt/ * *

Or run this one-liner:

echo "deb [trusted=yes] https://repo.noflux.app/apt/ * *" | sudo tee /etc/apt/sources.list.d/noflux.list > /dev/null

Update the list of packages:

apt update

Then install the package:

apt install noflux

To upgrade Noflux, run apt upgrade noflux, and don’t forget to run the database migrations.

The previous repository URL https://apt.noflux.app/ is deprecated in favor of https://repo.noflux.app/apt/.

Configure Noflux

  1. Define the environment variable DATABASE_URL in /etc/noflux.conf
  2. Run the SQL migrations manually: noflux -migrate -config-file /etc/noflux.conf, or set the variable RUN_MIGRATIONS=1 in /etc/noflux.conf
  3. Create an admin user: noflux -create-admin -config-file /etc/noflux.conf
  4. Restart the process: systemctl restart noflux
  5. Check the process status: systemctl status noflux

The Debian package is available for multiple architectures: amd64, arm64, and armhf. This way, it’s very easy to install Noflux on a Raspberry Pi.

Systemd reads the environment variables from the file /etc/noflux.conf. You must restart the service to take the new values into consideration.

Make sure to take a look at the list of configuration parameters to customize your installation.