Skip to main content

Documentation Index

Fetch the complete documentation index at: https://flox-kanishk-copy-page-as-markdown.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

This document describes a practical method for installing Flox from its repositories. Depending on your requirements, this approach may make it easier to create and manage scripts to install Flox on local systems or build it into containers. In addition, systems configured using this method will receive Flox updates as they are released.
When you download and install a Flox .deb or .rpm package, the installer performs these steps for you. But you can easily script the steps below to automate this process.
These instructions cover the process of installing from Flox’s repository on modern Debian- and Red Hat-based Linux distributions, such as Ubuntu and Linux Mint (Debian), or Fedora, RHEL, and Rocky Linux (Red Hat). They also include an alternate method for installing Flox on Linux systems, such as older versions of CentOS, where yum is the default package manager.

​
Installation overview

Adding Flox’s repository to a Debian- or Red Hat-based Linux system’s sources involves the following steps:
  • Importing Flox’s GPG keys to verify authenticity;
  • Configuring the system’s package manager to recognize Flox’s repository; and
  • Installing Flox.

​
Debian-based systems

To perform these steps on a Debian-based distribution using apt, do the following. First, download Flox’s GPG keyring to /usr/share/keyrings/. 
wget -qO - https://downloads.flox.dev/by-env/stable/deb/flox-archive-keyring.gpg | sudo tee /usr/share/keyrings/flox-archive-keyring.gpg >/dev/null
Next, add the Flox repository to /etc/apt/sources.list.d/flox.list, pinning it to the keyring you just downloaded. 
echo "deb [signed-by=/usr/share/keyrings/flox-archive-keyring.gpg] https://downloads.flox.dev/by-env/stable/deb/ stable/" | sudo tee /etc/apt/sources.list.d/flox.list >/dev/null
Finally, update and install Flox. 
sudo apt update && sudo apt install flox -y
These instructions use the modern signed-by method, which binds the GPG key to only the Flox repository. If you are running an end-of-life release (Debian 9 or earlier, Ubuntu 18.04 or earlier) that does not support signed-by, see the Debian SecureApt wiki for the legacy trusted.gpg.d approach.

​
Red Hat-based systems

To perform these steps on modern Red Hat-based distributions that use dnf, do the following. First, download Flox’s GPG keyring. 
sudo rpm --import https://downloads.flox.dev/by-env/stable/rpm/flox-archive-keyring.asc
Next, add Flox’s repository to /etc/yum.repos.d/flox.repo. 
sudo dnf config-manager --add-repo https://downloads.flox.dev/by-env/stable/rpm
Finally, install Flox. 
sudo dnf install flox

​
Installing from Flox’s repository using yum

In CentOS 8 and later, as with Fedora, RHEL, Rocky Linux, and other modern Red Hat-based systems, dnf is the default package manager. However, CentOS 7 and earlier ship with yum as the default, and dnf is not available. Since dnf is not available on those systems, the method described above won’t work. This section describes an alternative method for installing from Flox’s repository using rpm and yum.
Even though the method outlined here deals specifically with older versions of CentOS, it should also work on any Red Hat-based distribution for which yum is the default.
To install Flox from its repository using yum, do the following. First, download and import Flox’s GPG key. 
sudo rpm --import https://downloads.flox.dev/by-env/stable/rpm/flox-archive-keyring.asc
Next, configure the Flox repository and install Flox with yum. 
sudo yum --repofrompath=flox,https://downloads.flox.dev/by-env/stable/rpm install flox

​
Removing the Flox repository

To remove Flox’s repository from a Linux system’s sources, do the following.

​
Removing on Debian-based systems

By default, the Flox repository’s source list is in /etc/apt/sources.list.d/flox.list. However, you can double-check this by running the following command: 
grep -r 'flox' /etc/apt/sources.list /etc/apt/sources.list.d/
Once you’ve confirmed the existence and location of this file, delete it along with the GPG keyring. 
sudo rm /etc/apt/sources.list.d/flox.list
sudo rm /usr/share/keyrings/flox-archive-keyring.gpg
Finally, update your package list. 
sudo apt update
If you originally installed Flox via the .deb package rather than following these manual steps, the repository file may be named flox.sources (DEB822 format) instead of flox.list. Use the grep command above to verify the actual filename.

​
Removing on Red Hat-based systems

By default, the Flox repository’s source list is in /etc/yum.repos.d/flox.repo. However, you can double-check this by running the following command: 
sudo dnf repolist | grep flox
Delete the flox.repo file from /etc/yum.repos.d/. 
sudo rm /etc/yum.repos.d/flox.repo
Finally, clean the dnf cache. 
sudo dnf clean all

​
Where to next?