// reference

Guided setup (init)

Wizard prompts for two paths, creates a config, and after that you just mount. Here, the point is not needing flags or environment variables.

prismafs init creates ~/.config/prismafs/default.conf. After that, prismafs <mountpoint> doesnt need flags or environment variables.

In this step, unmount first if mount is still up from previous examples. Then without touching your real home config:

mkdir -p /tmp/pfs-home
unset SESSION_LAYER_DIR BASE_LAYER_DIRS
HOME=/tmp/pfs-home prismafs init

First prompt is SESSION (where writes go). Second is BASE (read-only original). Type full paths. Do not use ~/ here: HOME is overridden, so ~ would expand under /tmp/pfs-home.

macOS (after : is what you type):

Session layer directory for writes: /Users/YOU/pfs-session
Base layer directory (READ-ONLY, example: /): /Users/YOU/pfs-base

Linux:

Session layer directory for writes: /home/YOU/pfs-session
Base layer directory (READ-ONLY, example: /): /home/YOU/pfs-base

Then:

cat /tmp/pfs-home/.config/prismafs/default.conf
HOME=/tmp/pfs-home prismafs ~/pfs-mnt
ls ~/pfs-mnt

Unmount:

On macOS:

umount ~/pfs-mnt

On Linux:

fusermount3 -u ~/pfs-mnt

Config lists these two absolute paths. Mount works without -c or env vars. ls shows hello.txt. If you already excuted examples from b to d, session leftovers (link.txt, new.txt) also appear. dev is synthetic entry (ignore for now).

If you skip init, use -c or SESSION_LAYER_DIR / BASE_LAYER_DIRS like in Configuration above.