Installation From Source

Installation From Source

Linux

1. Install Go

Follow these instructions to install the latest version of Go.

2. Clone the Cloudfuse repository

git clone https://github.com/Seagate/cloudfuse/
cd cloudfuse
git checkout -b main origin/main

If you do not have git, install it via:

sudo apt-get install git

3. Install build dependencies

Cloudfuse compiles with cgo and the build script uses Zig as the C/C++ compiler driver (zig cc / zig c++). You must have libfuse development libraries and Zig installed on Linux.

Debian / Ubuntu

sudo apt-get update
sudo apt-get install -y libfuse-dev zig

CentOS / RHEL / Fedora

sudo yum install -y fuse fuse-libs zig

Notes:

• If your distribution packages Zig under a different name, install Zig from the upstream package or official instructions.

4. Build using the provided script

The repository includes a build script at the repository root (build.sh). The script:

• On Linux:
  • By default builds cloudfuse with the fuse3 support. To build with fuse2 (for an older version of Linux) instead, pass the single argument fuse2:
    • Default (fuse3): ./build.sh
    • Build for fuse2: ./build.sh fuse2
  • Always builds the health-monitor binary (cfusemon).
• On Windows (via Git Bash), the script builds:
  • cloudfuse.exe
  • cfusemon.exe (health monitor)
  • windows-startup.exe (startup tool)
  • windows-service.exe

Run the build script:

./build.sh

If you only want to build with fuse2:

./build.sh fuse2

---

Windows

1. Install Go

Follow these instructions to install the latest version of Go.

2. Clone the Cloudfuse repository

Using Git Bash on Windows:

git clone https://github.com/Seagate/cloudfuse/
cd cloudfuse
git checkout -b main origin/main

If you do not have git, install it from here.

3. Install WinFSP

Follow these instructions to install WinFSP.

4. Build

Run the build script from Git Bash:

./build.sh

This will produce:

• cloudfuse.exe
• cfusemon.exe
• windows-startup.exe
• windows-service.exe