PrismaFSnlnet

// getting-started

Configuration

PrismaFS resolves its layer configuration in this order:

  1. -c <config-file> command-line flag, if given.
  2. SESSION_LAYER_DIR and BASE_LAYER_DIRS environment variables, if -c is not given.
  3. Auto-detected config file at ~/.config/prismafs/default.conf, if neither of the above is given.
  4. If none of the above resolve, PrismaFS prints usage guidance and exits without mounting.

Guided setup

prismafs init

Prompts for a session directory and a base directory, then writes ~/.config/prismafs/default.conf. After this, running prismafs <mountpoint> with no other arguments uses this file automatically.

Config file format

Plain text, one directive per line. Lines starting with # are comments, empty lines ignored.

# my analysis environment
session /tmp/session
base /opt/project-base
base /usr/local/share/common
  • session <path>: required, exactly once. Directory used for all writes.
  • base <path>: required, at least once. Repeatable. Order sets read priority, first listed wins on name collisions across base layers.

Environment variable format

export SESSION_LAYER_DIR=/tmp/session
export BASE_LAYER_DIRS=/tmp/base1,/tmp/base2

BASE_LAYER_DIRS is a comma-separated list. Order sets read priority, same as the config file.