Download

Choose your edition

MooseFS 4 CE is open source under GPLv2 and free forever — ideal for development, evaluation, and smaller deployments. MooseFS 5 Pro Personal gives individual developers and home-lab users the full Pro feature set (automatic failover, multi-location clusters, advanced erasure coding) with no credentials required — free up to 20 TiB raw capacity under a non-commercial license. For production and commercial use, MooseFS 4 Pro and MooseFS 5 Pro add 24/7 support and dedicated releases; request a quote and we’ll send your repository credentials with the offer.

Source on GitHub Supported versions Documentation

Install instructions

Install MooseFS

Binary packages for every supported Linux distribution, FreeBSD, Raspbian, and macOS, served from the official MooseFS repository. MooseFS ships in several editions — pick the one that matches your use case below, select your operating system, paste the commands, and you’re ready to install master, chunkserver, metalogger, or client packages.

Open source under GPLv2 — free forever. Current release: 4.59.2. Source on GitHub

Commands are reproduced verbatim from the official repository — copy and paste should just work. Run each block as root. On systems no longer supported by their manufacturer, our support is limited even though we still build packages for those releases.

1 Add the MooseFS repository

Pick the block that matches your Ubuntu release. Supported releases: 24.04 (Noble), 22.04 (Jammy), 20.04 (Focal), 18.04 (Bionic), 16.04 (Xenial) on amd64; Focal & Jammy also for arm64 and armhf.

Ubuntu 24.04 (Noble) — amd64

curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
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
apt update

Ubuntu 22.04 (Jammy) — amd64, arm64, armhf

amd64

curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-4/apt/ubuntu/jammy jammy main" > /etc/apt/sources.list.d/moosefs.list
apt update

arm64

curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=arm64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-4/apt/ubuntu/jammy jammy main" > /etc/apt/sources.list.d/moosefs.list
apt update

armhf

curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=armhf signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-4/apt/ubuntu/jammy jammy main" > /etc/apt/sources.list.d/moosefs.list
apt update

Ubuntu 20.04 (Focal) — amd64, arm64, armhf

amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb [arch=amd64] http://repository.moosefs.com/moosefs-4/apt/ubuntu/focal focal main" > /etc/apt/sources.list.d/moosefs.list
apt update

arm64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb [arch=arm64] http://repository.moosefs.com/moosefs-4/apt/ubuntu/focal focal main" > /etc/apt/sources.list.d/moosefs.list
apt update

armhf

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb [arch=armhf] http://repository.moosefs.com/moosefs-4/apt/ubuntu/focal focal main" > /etc/apt/sources.list.d/moosefs.list
apt update

Ubuntu 18.04 (Bionic) — amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-4/apt/ubuntu/bionic bionic main" > /etc/apt/sources.list.d/moosefs.list
apt update

Ubuntu 16.04 (Xenial) — amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-4/apt/ubuntu/xenial xenial main" > /etc/apt/sources.list.d/moosefs.list
apt update

2 Install the packages you need

Install only the roles each host will play. A small cluster has one master, one or more chunkservers, and clients on every machine that needs to mount the filesystem.

Master server

# apt install moosefs-master moosefs-cli moosefs-gui

Chunkserver

# apt install moosefs-chunkserver

Metalogger

# apt install moosefs-metalogger

Client

# apt install moosefs-client

1 Add the MooseFS repository

Pick the block that matches your Debian release. Supported releases: 13 (Trixie), 12 (Bookworm), 11 (Bullseye), 10 (Buster), 9 (Stretch).

Debian 13 (Trixie) — amd64

mkdir -p /etc/apt/keyrings
curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-4/apt/debian/trixie trixie main" > /etc/apt/sources.list.d/moosefs.list
apt update

Debian 12 (Bookworm) — amd64

mkdir -p /etc/apt/keyrings
curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
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
apt update

Debian 11 (Bullseye) — amd64

mkdir -p /etc/apt/keyrings
curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-4/apt/debian/bullseye bullseye main" > /etc/apt/sources.list.d/moosefs.list
apt update

Debian 10 (Buster) — amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-4/apt/debian/buster buster main" > /etc/apt/sources.list.d/moosefs.list
apt update

Debian 9 (Stretch) — amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-4/apt/debian/stretch stretch main" > /etc/apt/sources.list.d/moosefs.list
apt update

2 Install the packages you need

Master server

# apt install moosefs-master moosefs-cli moosefs-gui

Chunkserver

# apt install moosefs-chunkserver

Metalogger

# apt install moosefs-metalogger

Client

# apt install moosefs-client

1 Import the GPG key and the repository

The same commands cover Red Hat Enterprise Linux, CentOS, Rocky Linux, AlmaLinux, Fedora, and SUSE. Pick the .repo file that matches your EL generation: EL10, EL9, EL8, or EL7.

EL10 — RHEL 10, CentOS Stream 10, Rocky 10, Alma 10, Fedora 40+

curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
curl "http://repository.moosefs.com/MooseFS-4-el10.repo" > /etc/yum.repos.d/MooseFS.repo
yum update

EL9 — RHEL 9, CentOS Stream 9, Rocky 9, Alma 9

curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
curl "http://repository.moosefs.com/MooseFS-4-el9.repo" > /etc/yum.repos.d/MooseFS.repo
yum update

EL8 — RHEL 8, CentOS 8, Rocky 8, Alma 8

curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
curl "http://repository.moosefs.com/MooseFS-4-el8.repo" > /etc/yum.repos.d/MooseFS.repo
yum update

EL7 — RHEL 7, CentOS 7

curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
curl "http://repository.moosefs.com/MooseFS-4-el7.repo" > /etc/yum.repos.d/MooseFS.repo
yum update

2 Install the packages you need

Master server

# yum install moosefs-master moosefs-cli moosefs-gui

Chunkserver

# yum install moosefs-chunkserver

Metalogger

# yum install moosefs-metalogger

Client

# yum install moosefs-client

1 Configure the MooseFS pkg repository

Create /usr/local/etc/pkg/repos/moosefs.conf with the line for your FreeBSD version and architecture, then refresh with pkg update. Supported versions: 14, 13, 12, 11, each in 32-bit (x86:32) and 64-bit (x86:64) flavours.

FreeBSD 14 — 32-bit and 64-bit

64-bit moosefs: { url: "http://repository.moosefs.com/moosefs-4/freebsd/14:x86:64", enabled: yes, mirror_type: NONE } 32-bit moosefs: { url: "http://repository.moosefs.com/moosefs-4/freebsd/14:x86:32", enabled: yes, mirror_type: NONE }

FreeBSD 13 — 32-bit and 64-bit

64-bit moosefs: { url: "http://repository.moosefs.com/moosefs-4/freebsd/13:x86:64", enabled: yes, mirror_type: NONE } 32-bit moosefs: { url: "http://repository.moosefs.com/moosefs-4/freebsd/13:x86:32", enabled: yes, mirror_type: NONE }

FreeBSD 12 — 32-bit and 64-bit

64-bit moosefs: { url: "http://repository.moosefs.com/moosefs-4/freebsd/12:x86:64", enabled: yes, mirror_type: NONE } 32-bit moosefs: { url: "http://repository.moosefs.com/moosefs-4/freebsd/12:x86:32", enabled: yes, mirror_type: NONE }

FreeBSD 11 — 32-bit and 64-bit

64-bit moosefs: { url: "http://repository.moosefs.com/moosefs-4/freebsd/11:x86:64", enabled: yes, mirror_type: NONE } 32-bit moosefs: { url: "http://repository.moosefs.com/moosefs-4/freebsd/11:x86:32", enabled: yes, mirror_type: NONE }

Then refresh the package index pkg update

2 Install the packages you need

Master server

# pkg install moosefs-master moosefs-cli moosefs-gui

Chunkserver

# pkg install moosefs-chunkserver

Metalogger

# pkg install moosefs-metalogger

Client

# pkg install moosefs-client

1 Add the MooseFS repository

Raspbian uses the Debian armhf packages directly. Supported releases: 11 (Bullseye), 10 (Buster).

Raspbian 11 (Bullseye)

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-4/apt/debian/bullseye bullseye main" > /etc/apt/sources.list.d/moosefs.list
apt update

Raspbian 10 (Buster)

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-4/apt/debian/buster buster main" > /etc/apt/sources.list.d/moosefs.list
apt update

2 Install the packages you need

Master server

# apt install moosefs-master moosefs-cli moosefs-gui

Chunkserver

# apt install moosefs-chunkserver

Metalogger

# apt install moosefs-metalogger

Client

# apt install moosefs-client

1 Install FUSE for macOS first

MooseFS on macOS relies on a FUSE driver. Download and install FUSE for macOS before you install MooseFS itself.

osxfuse.github.io

2 Download the MooseFS .pkg installers

Binary .pkg installers for macOS 12 and later are served from the official repository. Start scripts are not included — run the daemons by hand or wire them into launchd yourself.

Browse macOS .pkg files

Personal, non-commercial use. The MooseFS 5 Pro repository is freely accessible — no credentials required. Use is subject to the Personal license terms: free up to 20 TiB raw capacity, then 9 € per TB. Check your limits and compare editions

Commands are reproduced verbatim from the official repository — copy and paste should just work. Run each block as root. On systems no longer supported by their manufacturer, our support is limited even though we still build packages for those releases.

1 Add the MooseFS repository

Pick the block that matches your Ubuntu release. Supported releases: 24.04 (Noble), 22.04 (Jammy), 20.04 (Focal), 18.04 (Bionic), 16.04 (Xenial) on amd64; Focal & Jammy also for arm64 and armhf.

Ubuntu 24.04 (Noble) — amd64

curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/ubuntu/noble noble main" > /etc/apt/sources.list.d/moosefs.list
apt update

Ubuntu 22.04 (Jammy) — amd64, arm64, armhf

amd64

curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/ubuntu/jammy jammy main" > /etc/apt/sources.list.d/moosefs.list
apt update

arm64

curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=arm64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/ubuntu/jammy jammy main" > /etc/apt/sources.list.d/moosefs.list
apt update

armhf

curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=armhf signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/ubuntu/jammy jammy main" > /etc/apt/sources.list.d/moosefs.list
apt update

Ubuntu 20.04 (Focal) — amd64, arm64, armhf

amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb [arch=amd64] http://repository.moosefs.com/moosefs-5/apt/ubuntu/focal focal main" > /etc/apt/sources.list.d/moosefs.list
apt update

arm64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb [arch=arm64] http://repository.moosefs.com/moosefs-5/apt/ubuntu/focal focal main" > /etc/apt/sources.list.d/moosefs.list
apt update

armhf

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb [arch=armhf] http://repository.moosefs.com/moosefs-5/apt/ubuntu/focal focal main" > /etc/apt/sources.list.d/moosefs.list
apt update

Ubuntu 18.04 (Bionic) — amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-5/apt/ubuntu/bionic bionic main" > /etc/apt/sources.list.d/moosefs.list
apt update

Ubuntu 16.04 (Xenial) — amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-5/apt/ubuntu/xenial xenial main" > /etc/apt/sources.list.d/moosefs.list
apt update

2 Install the packages you need

Install only the roles each host will play. A small cluster has one master, one or more chunkservers, and clients on every machine that needs to mount the filesystem.

Master server

# apt install moosefs-pro-master moosefs-pro-cli moosefs-pro-gui

Chunkserver

# apt install moosefs-pro-chunkserver

Metalogger

# apt install moosefs-pro-metalogger

Client

# apt install moosefs-pro-client

1 Add the MooseFS repository

Pick the block that matches your Debian release. Supported releases: 13 (Trixie), 12 (Bookworm), 11 (Bullseye), 10 (Buster), 9 (Stretch).

Debian 13 (Trixie) — amd64

mkdir -p /etc/apt/keyrings
curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/debian/trixie trixie main" > /etc/apt/sources.list.d/moosefs.list
apt update

Debian 12 (Bookworm) — amd64

mkdir -p /etc/apt/keyrings
curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/debian/bookworm bookworm main" > /etc/apt/sources.list.d/moosefs.list
apt update

Debian 11 (Bullseye) — amd64

mkdir -p /etc/apt/keyrings
curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/debian/bullseye bullseye main" > /etc/apt/sources.list.d/moosefs.list
apt update

Debian 10 (Buster) — amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-5/apt/debian/buster buster main" > /etc/apt/sources.list.d/moosefs.list
apt update

Debian 9 (Stretch) — amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-5/apt/debian/stretch stretch main" > /etc/apt/sources.list.d/moosefs.list
apt update

2 Install the packages you need

Master server

# apt install moosefs-pro-master moosefs-pro-cli moosefs-pro-gui

Chunkserver

# apt install moosefs-pro-chunkserver

Metalogger

# apt install moosefs-pro-metalogger

Client

# apt install moosefs-pro-client

1 Import the GPG key and the repository

The same commands cover Red Hat Enterprise Linux, CentOS, Rocky Linux, AlmaLinux, Fedora, and SUSE. Pick the .repo file that matches your EL generation: EL10, EL9, EL8, or EL7.

EL10 — RHEL 10, CentOS Stream 10, Rocky 10, Alma 10, Fedora 40+

curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
curl "http://repository.moosefs.com/MooseFS-5-el10.repo" > /etc/yum.repos.d/MooseFS.repo
yum update

EL9 — RHEL 9, CentOS Stream 9, Rocky 9, Alma 9

curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
curl "http://repository.moosefs.com/MooseFS-5-el9.repo" > /etc/yum.repos.d/MooseFS.repo
yum update

EL8 — RHEL 8, CentOS 8, Rocky 8, Alma 8

curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
curl "http://repository.moosefs.com/MooseFS-5-el8.repo" > /etc/yum.repos.d/MooseFS.repo
yum update

EL7 — RHEL 7, CentOS 7

curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
curl "http://repository.moosefs.com/MooseFS-5-el7.repo" > /etc/yum.repos.d/MooseFS.repo
yum update

2 Install the packages you need

Master server

# yum install moosefs-pro-master moosefs-pro-cli moosefs-pro-gui

Chunkserver

# yum install moosefs-pro-chunkserver

Metalogger

# yum install moosefs-pro-metalogger

Client

# yum install moosefs-pro-client

1 Configure the MooseFS pkg repository

Create /usr/local/etc/pkg/repos/moosefs.conf with the line for your FreeBSD version and architecture, then refresh with pkg update. Supported versions: 14, 13, 12, 11, each in 32-bit (x86:32) and 64-bit (x86:64) flavours.

FreeBSD 14 — 32-bit and 64-bit

64-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/14:x86:64", enabled: yes, mirror_type: NONE } 32-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/14:x86:32", enabled: yes, mirror_type: NONE }

FreeBSD 13 — 32-bit and 64-bit

64-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/13:x86:64", enabled: yes, mirror_type: NONE } 32-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/13:x86:32", enabled: yes, mirror_type: NONE }

FreeBSD 12 — 32-bit and 64-bit

64-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/12:x86:64", enabled: yes, mirror_type: NONE } 32-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/12:x86:32", enabled: yes, mirror_type: NONE }

FreeBSD 11 — 32-bit and 64-bit

64-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/11:x86:64", enabled: yes, mirror_type: NONE } 32-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/11:x86:32", enabled: yes, mirror_type: NONE }

Then refresh the package index pkg update

2 Install the packages you need

Master server

# pkg install moosefs-pro-master moosefs-pro-cli moosefs-pro-gui

Chunkserver

# pkg install moosefs-pro-chunkserver

Metalogger

# pkg install moosefs-pro-metalogger

Client

# pkg install moosefs-pro-client

1 Add the MooseFS repository

Raspbian uses the Debian armhf packages directly. Supported releases: 11 (Bullseye), 10 (Buster).

Raspbian 11 (Bullseye)

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-5/apt/debian/bullseye bullseye main" > /etc/apt/sources.list.d/moosefs.list
apt update

Raspbian 10 (Buster)

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-5/apt/debian/buster buster main" > /etc/apt/sources.list.d/moosefs.list
apt update

2 Install the packages you need

Master server

# apt install moosefs-pro-master moosefs-pro-cli moosefs-pro-gui

Chunkserver

# apt install moosefs-pro-chunkserver

Metalogger

# apt install moosefs-pro-metalogger

Client

# apt install moosefs-pro-client

1 Install FUSE for macOS first

MooseFS on macOS relies on a FUSE driver. Download and install FUSE for macOS before you install MooseFS itself.

osxfuse.github.io

2 Download the MooseFS .pkg installers

Binary .pkg installers for macOS 12 and later are served from the official repository. Start scripts are not included — run the daemons by hand or wire them into launchd yourself.

Browse macOS .pkg files

Commercial editions

MooseFS 4 Pro and MooseFS 5 Pro are commercial editions for production deployments. They include automatic master failover, multi-location clusters, advanced erasure coding with up to 9 parity sums, a native Windows client, and 24/7 support direct from the development team.

Request a quote and we’ll send your repository access credentials together with the offer. Compare all editions

Request a Pro quote

No credentials needed for MooseFS 5. The commands below install MooseFS 5 Pro, which is freely accessible from the repository — no authentication required. If you are running MooseFS 4 Pro, repository access requires the credentials included in your quote; we recommend upgrading to MooseFS 5 instead.

Commands are reproduced verbatim from the official repository — copy and paste should just work. Run each block as root. On systems no longer supported by their manufacturer, our support is limited even though we still build packages for those releases.

1 Add the MooseFS repository

Pick the block that matches your Ubuntu release. Supported releases: 24.04 (Noble), 22.04 (Jammy), 20.04 (Focal), 18.04 (Bionic), 16.04 (Xenial) on amd64; Focal & Jammy also for arm64 and armhf.

Ubuntu 24.04 (Noble) — amd64

curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/ubuntu/noble noble main" > /etc/apt/sources.list.d/moosefs.list
apt update

Ubuntu 22.04 (Jammy) — amd64, arm64, armhf

amd64

curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/ubuntu/jammy jammy main" > /etc/apt/sources.list.d/moosefs.list
apt update

arm64

curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=arm64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/ubuntu/jammy jammy main" > /etc/apt/sources.list.d/moosefs.list
apt update

armhf

curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=armhf signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/ubuntu/jammy jammy main" > /etc/apt/sources.list.d/moosefs.list
apt update

Ubuntu 20.04 (Focal) — amd64, arm64, armhf

amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb [arch=amd64] http://repository.moosefs.com/moosefs-5/apt/ubuntu/focal focal main" > /etc/apt/sources.list.d/moosefs.list
apt update

arm64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb [arch=arm64] http://repository.moosefs.com/moosefs-5/apt/ubuntu/focal focal main" > /etc/apt/sources.list.d/moosefs.list
apt update

armhf

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb [arch=armhf] http://repository.moosefs.com/moosefs-5/apt/ubuntu/focal focal main" > /etc/apt/sources.list.d/moosefs.list
apt update

Ubuntu 18.04 (Bionic) — amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-5/apt/ubuntu/bionic bionic main" > /etc/apt/sources.list.d/moosefs.list
apt update

Ubuntu 16.04 (Xenial) — amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-5/apt/ubuntu/xenial xenial main" > /etc/apt/sources.list.d/moosefs.list
apt update

2 Install the packages you need

Install only the roles each host will play. A small cluster has one master, one or more chunkservers, and clients on every machine that needs to mount the filesystem.

Master server

# apt install moosefs-pro-master moosefs-pro-cli moosefs-pro-gui

Chunkserver

# apt install moosefs-pro-chunkserver

Metalogger

# apt install moosefs-pro-metalogger

Client

# apt install moosefs-pro-client

1 Add the MooseFS repository

Pick the block that matches your Debian release. Supported releases: 13 (Trixie), 12 (Bookworm), 11 (Bullseye), 10 (Buster), 9 (Stretch).

Debian 13 (Trixie) — amd64

mkdir -p /etc/apt/keyrings
curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/debian/trixie trixie main" > /etc/apt/sources.list.d/moosefs.list
apt update

Debian 12 (Bookworm) — amd64

mkdir -p /etc/apt/keyrings
curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/debian/bookworm bookworm main" > /etc/apt/sources.list.d/moosefs.list
apt update

Debian 11 (Bullseye) — amd64

mkdir -p /etc/apt/keyrings
curl https://repository.moosefs.com/moosefs.key | gpg -o /etc/apt/keyrings/moosefs.gpg --dearmor
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/moosefs.gpg] http://repository.moosefs.com/moosefs-5/apt/debian/bullseye bullseye main" > /etc/apt/sources.list.d/moosefs.list
apt update

Debian 10 (Buster) — amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-5/apt/debian/buster buster main" > /etc/apt/sources.list.d/moosefs.list
apt update

Debian 9 (Stretch) — amd64

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-5/apt/debian/stretch stretch main" > /etc/apt/sources.list.d/moosefs.list
apt update

2 Install the packages you need

Master server

# apt install moosefs-pro-master moosefs-pro-cli moosefs-pro-gui

Chunkserver

# apt install moosefs-pro-chunkserver

Metalogger

# apt install moosefs-pro-metalogger

Client

# apt install moosefs-pro-client

1 Import the GPG key and the repository

The same commands cover Red Hat Enterprise Linux, CentOS, Rocky Linux, AlmaLinux, Fedora, and SUSE. Pick the .repo file that matches your EL generation: EL10, EL9, EL8, or EL7.

EL10 — RHEL 10, CentOS Stream 10, Rocky 10, Alma 10, Fedora 40+

curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
curl "http://repository.moosefs.com/MooseFS-5-el10.repo" > /etc/yum.repos.d/MooseFS.repo
yum update

EL9 — RHEL 9, CentOS Stream 9, Rocky 9, Alma 9

curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
curl "http://repository.moosefs.com/MooseFS-5-el9.repo" > /etc/yum.repos.d/MooseFS.repo
yum update

EL8 — RHEL 8, CentOS 8, Rocky 8, Alma 8

curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
curl "http://repository.moosefs.com/MooseFS-5-el8.repo" > /etc/yum.repos.d/MooseFS.repo
yum update

EL7 — RHEL 7, CentOS 7

curl "https://repository.moosefs.com/RPM-GPG-KEY-MooseFS" > /etc/pki/rpm-gpg/RPM-GPG-KEY-MooseFS
curl "http://repository.moosefs.com/MooseFS-5-el7.repo" > /etc/yum.repos.d/MooseFS.repo
yum update

2 Install the packages you need

Master server

# yum install moosefs-pro-master moosefs-pro-cli moosefs-pro-gui

Chunkserver

# yum install moosefs-pro-chunkserver

Metalogger

# yum install moosefs-pro-metalogger

Client

# yum install moosefs-pro-client

1 Configure the MooseFS pkg repository

Create /usr/local/etc/pkg/repos/moosefs.conf with the line for your FreeBSD version and architecture, then refresh with pkg update. Supported versions: 14, 13, 12, 11, each in 32-bit (x86:32) and 64-bit (x86:64) flavours.

FreeBSD 14 — 32-bit and 64-bit

64-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/14:x86:64", enabled: yes, mirror_type: NONE } 32-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/14:x86:32", enabled: yes, mirror_type: NONE }

FreeBSD 13 — 32-bit and 64-bit

64-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/13:x86:64", enabled: yes, mirror_type: NONE } 32-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/13:x86:32", enabled: yes, mirror_type: NONE }

FreeBSD 12 — 32-bit and 64-bit

64-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/12:x86:64", enabled: yes, mirror_type: NONE } 32-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/12:x86:32", enabled: yes, mirror_type: NONE }

FreeBSD 11 — 32-bit and 64-bit

64-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/11:x86:64", enabled: yes, mirror_type: NONE } 32-bit moosefs: { url: "http://repository.moosefs.com/moosefs-5/freebsd/11:x86:32", enabled: yes, mirror_type: NONE }

Then refresh the package index pkg update

2 Install the packages you need

Master server

# pkg install moosefs-pro-master moosefs-pro-cli moosefs-pro-gui

Chunkserver

# pkg install moosefs-pro-chunkserver

Metalogger

# pkg install moosefs-pro-metalogger

Client

# pkg install moosefs-pro-client

1 Add the MooseFS repository

Raspbian uses the Debian armhf packages directly. Supported releases: 11 (Bullseye), 10 (Buster).

Raspbian 11 (Bullseye)

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-5/apt/debian/bullseye bullseye main" > /etc/apt/sources.list.d/moosefs.list
apt update

Raspbian 10 (Buster)

wget -O - https://repository.moosefs.com/moosefs.key | apt-key add -
echo "deb http://repository.moosefs.com/moosefs-5/apt/debian/buster buster main" > /etc/apt/sources.list.d/moosefs.list
apt update

2 Install the packages you need

Master server

# apt install moosefs-pro-master moosefs-pro-cli moosefs-pro-gui

Chunkserver

# apt install moosefs-pro-chunkserver

Metalogger

# apt install moosefs-pro-metalogger

Client

# apt install moosefs-pro-client

1 Install FUSE for macOS first

MooseFS on macOS relies on a FUSE driver. Download and install FUSE for macOS before you install MooseFS itself.

osxfuse.github.io

2 Download the MooseFS .pkg installers

Binary .pkg installers for macOS 12 and later are served from the official repository. Start scripts are not included — run the daemons by hand or wire them into launchd yourself. Use the credentials received with your quote to access the repository.

Browse macOS .pkg files

Source & previous releases

Build from source, or pin an older version

The full MooseFS source tree lives on GitHub. If you need a specific older point release, the repository keeps every version stream alongside the latest one — you just swap the version in the URL.

Source code on GitHub

MooseFS Community is open source under GPLv2. Clone the repository to build from source, audit the code, or contribute a patch.

github.com/moosefs/moosefs

Install an older version

Replace moosefs-4 or moosefs-5 in any repository URL above with a specific stream — e.g. moosefs-4.58.1 — to install that exact version. Useful when you’re mirroring a known-good production deployment.

Supported version timeline

Upgrading?

MooseFS supports rolling upgrades — you can move from one major version to the next without taking the cluster offline. The documentation has step-by-step instructions per upgrade path.

How to upgrade

Next steps

Installed? Here’s where to go next

The documentation walks through the first cluster: starting the master, registering chunkservers, mounting from a client, and setting your replication goal. The support team is one email away if you get stuck.

Open the documentation Get help Request a Pro quote