Download

Install MooseFS 4

Binary packages for every supported Linux distribution, FreeBSD, Raspbian, and macOS, served from the official MooseFS repository. The current stream is MooseFS 4 (Community edition, GPLv2) — latest release 4.59.2. Pick your OS below, paste the commands, and you’re ready to install master, chunkserver, metalogger, or client packages.

Need the commercial Pro edition with automatic failover, multi-location clusters, and 24/7 support? Request a Pro quote — we’ll send your repository credentials with the offer.

Source on GitHub Supported versions Documentation

Install instructions

Choose your operating system

Commands are reproduced verbatim from the official repository — copy and paste should just work. Run each block as root (the leading # in the prompt is shown for clarity and is not part of the command).

1 Add the MooseFS repository

Pick the block that matches your Ubuntu release. Supported releases: 16.04 (Xenial), 18.04 (Bionic), 20.04 (Focal), 22.04 (Jammy), 24.04 (Noble) 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: 9 (Stretch), 10 (Buster), 11 (Bullseye), 12 (Bookworm), 13 (Trixie).

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: EL7, EL8, EL9, or EL10.

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: 11, 12, 13, 14, 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: 10 (Buster), 11 (Bullseye).

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

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 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