Skip to main content

Adding MooseFS Repositories

Before installing MooseFS, you must configure your system to use the official MooseFS-supported repositories. This ensures you have access to the latest stable versions and security updates for all MooseFS components.

The following sections explain how to add repositories for various operating systems.

Ubuntu​

To install or update MooseFS on Ubuntu systems, follow these steps:

  1. Add the GPG key:

  • For Ubuntu 22.04 LTS / 24.04 LTS:

    curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor

  • For Ubuntu 16.04 LTS / 18.04 LTS / 20.04 LTS:

    wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
  1. Add the repository entry:
  • Example for Ubuntu 24.04 LTS (Noble) - amd64: 
    echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-4/apt/ubuntu/noble noble main" > /etc/apt/sources.list.d/moosefs.list
  • Other supported Ubuntu versions (Jammy, Focal, Bionic, Xenial) follow a similar pattern with appropriate architecture and release names.
  1. Update and install MooseFS components:
apt update
apt install moosefs-master moosefs-cgi moosefs-cgiserv moosefs-cli  # For Master Servers
apt install moosefs-chunkserver                                     # For Chunkservers
apt install moosefs-metalogger                                      # For Metaloggers
apt install moosefs-client                                          # For Clients
info

Note: For older Ubuntu distributions, change the release codename accordingly in the repository URL.

Debian​

To install or update MooseFS on Debian systems:

  1. Add the GPG key:
  • For Debian 11 (Bullseye) and newer: 
    mkdir -p /etc/apt/keyrings
    curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
  • For Debian 9 (Stretch) and Debian 10 (Buster): 
    wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
  1. Add the repository entry:
  • Example for Debian 12 (Bookworm): 
    echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-4/apt/debian/bookworm bookworm main" > /etc/apt/sources.list.d/moosefs.list
  1. Update and install MooseFS components:
apt update
apt install moosefs-master moosefs-cgi moosefs-cgiserv moosefs-cli  # For Master Servers
apt install moosefs-chunkserver                                     # For Chunkservers
apt install moosefs-metalogger                                      # For Metaloggers
apt install moosefs-client                                          # For Clients
info

Note: Modify the repository URL codename for older Debian versions accordingly.

RedHat / CentOS / Rocky Linux / AlmaLinux / Fedora / SUSE​

To install MooseFS on RedHat-based distributions:

  1. Add the GPG key:
curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
  1. Add the repository file:
  • Example for EL8: 
    curl "http://repository.moosefs.com/MooseFS-4-el8.repo" > /etc/yum.repos.d/MooseFS.repo
  1. Install MooseFS components:
yum install moosefs-master moosefs-cgi moosefs-cgiserv moosefs-cli  # For Master Servers
yum install moosefs-chunkserver                                     # For Chunkservers
yum install moosefs-metalogger                                      # For Metaloggers
yum install moosefs-client                                          # For Clients

FreeBSD​

To install or update MooseFS on FreeBSD:

  1. Create the repository configuration:
  • Example for FreeBSD 14 (64-bit): 
    echo 'moosefs: { url: "http://repository.moosefs.com/moosefs-4/freebsd/14:x86:64", enabled: yes, mirror_type: NONE }' > /etc/pkg/moosefs.conf
  1. Update and install MooseFS components:
pkg update
pkg install moosefs3-master moosefs3-cgi moosefs3-cgiserv moosefs3-cli  # For Master Servers
pkg install moosefs3-chunkserver                                        # For Chunkservers
pkg install moosefs3-metalogger                                         # For Metaloggers
pkg install moosefs3-client                                             # For Clients

macOS​

On macOS, MooseFS components (particularly clients) can be installed manually:

  1. Install FUSE for macOS:

  2. Install MooseFS binaries:

info

Note: macOS packages contain only binaries without startup scripts. Follow Apple’s guidelines if prompted when opening packages from unidentified developers:
Apple guide to open unidentified developer apps

Raspbian (Raspberry Pi)​

To install or update MooseFS on Raspbian:

  1. Add the GPG key:
wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
  1. Add the repository entry:
  • Example for Raspbian 11 (Bullseye): 
    echo "deb http://repository.moosefs.com/moosefs-4/apt/debian/bullseye bullseye main" > /etc/apt/sources.list.d/moosefs.list
  1. Update and install MooseFS components:
apt update
apt install moosefs-master moosefs-cgi moosefs-cgiserv moosefs-cli  # For Master Servers
apt install moosefs-chunkserver                                     # For Chunkservers
apt install moosefs-metalogger                                      # For Metaloggers
apt install moosefs-client                                          # For Clients

By properly configuring your system to use the official MooseFS repositories, you ensure access to stable updates, feature enhancements, and security patches, supporting a reliable and maintainable storage environment.