PrismaFS

// getting-started

Installation

macOS, via Homebrew

brew install goranb131/ithas-prismafs/prismafs

Installing by this qualified name trusts only this formula, so no separate tap or trust step is needed.

Longer approach, if you want to have tap added by name explicitly:

brew tap goranb131/ithas-prismafs
brew trust goranb131/ithas-prismafs
brew install prismafs

brew trust is required now since Homebrew 6.x. Without it, brew installfails with “Refusing to load formula ... from untrusted tap”.

First time from this tap, if Homebrew complains that formula is untrusted:

brew trust goranb131/ithas-prismafs
brew install goranb131/ithas-prismafs/prismafs

If it complains about newer Xcode Command Line Tools, it prints and instructs command you need to run. That command is:

xcode-select --install

Finish that, then run brew install goranb131/ithas-prismafs/prismafs again.

Or build from source:

git clone git@github.com:goranb131/ITHAS-prismaFS.git
cd ITHAS-prismaFS
make

Then ./prismafs from that directory, or sudo make install so the command is just prismafs.

Linux, build from source

git clone git@github.com:goranb131/ITHAS-prismaFS.git
cd ITHAS-prismaFS
make
sudo make install

make install places the binary at /usr/local/bin/prismafs and man pageunder /usr/local/share/man/man1.

Linux, requirement: FUSE 3. Package is fuse3 (gives you fusermount3). To build from source you also need the headers (libfuse3-dev or fuse3-devel) and pkg-config. Any current FUSE 3 is fine (tested with fusermount3 3.18.2).

# Debian / Ubuntu
sudo apt install fuse3 libfuse3-dev pkg-config

# Fedora / RHEL family
sudo dnf install fuse3 fuse3-devel pkgconf

# openSUSE
sudo zypper install fuse3 fuse3-devel pkgconf

# Arch
sudo pacman -S fuse3 pkgconf

# Alpine (musl)
sudo apk add fuse3 fuse3-dev pkgconf

Linux, prebuilt binary

Prebuilt, static linked (with libfuse3) x86_64 binary is available as alternative to building from source, attached to each GitHub Release. It has no dependency on host's libfuse3 shared library version. Only glibc, fusermount3, and kernel FUSE module are requirement on target machine. This is early stage development extra, because while MacOS version uses Homebrew, Linux has the binaries option, before packages are distributed in other formats later in Roadmap.

To install:

mkdir -p ~/.local/bin
cp prismafs-<version>-linux-x86_64-static ~/.local/bin/prismafs
chmod +x ~/.local/bin/prismafs

Or system global:

sudo cp prismafs-<version>-linux-x86_64-static /usr/local/bin/prismafs
sudo chmod +x /usr/local/bin/prismafs

At this earlier stage of development, PrismaFS also minds Alpine and other musl-based distros, so separate static binary is attached to same GitHub Release: prismafs-<version>-linux-x86_64-static-musl. It has musl and libfuse3 compiled in, so it has no dependency on host libc or libfuse3 version, and runs on any Linux distro, not only Alpine. Install steps are the same, just with this filename instead.

Run it by path:

chmod +x prismafs-1.7.1-linux-x86_64-static
./prismafs-1.7.1-linux-x86_64-static -v
/full/path/to/prismafs-1.7.1-linux-x86_64-static ~/pfs-mnt

Or put it under bin dir so the command is just prismafs (~/.local/bin must be in your PATH, or use /usr/local/bin):

mkdir -p ~/.local/bin
cp prismafs-1.7.1-linux-x86_64-static ~/.local/bin/prismafs
chmod +x ~/.local/bin/prismafs

Same two cp / chmod lines for the musl filename.

Fastest way to verify that install was success, or that binary works: prismafs -v (or ./prismafs -v from a source build, or the downloaded filename). It prints PrismaFS version and exits.

Simplest check that install worked, or that your binary runs is to print version with PrismaFS command. How you type it depends on where the file is:

  • Built from source, still inside repository after make: ./prismafs -v
  • Downloaded binary, still in the folder you saved it (Downloads or wherever): ./prismafs-1.7.1-linux-x86_64-static -v (or the musl filename). Or the full path: /full/path/to/prismafs-1.7.1-linux-x86_64-static -v
  • Already on PATH (Homebrew, sudo make install, or you copied it to ~/.local/bin / /usr/local/bin): just prismafs -v

If it prints PrismaFS Version: 1.7.1, you are good. Use this same format (./prismafs, downloaded filename, or prismafs) for all the remaining commands below.