Quick reference
At‑a‑glance defaults for a LeilFS cluster. All ports and paths are configurable in the respective component configuration files — see the configuration reference.
Default ports
| Port | Name | Between | Protocol |
|---|---|---|---|
9419 | MATOML | Master ↔ Metalogger | TCP |
9420 | MATOCS | Master ↔ Chunkserver | TCP |
9421 | MATOCL | Master ↔ Client (mount) | TCP |
9422 | CSTOCL | Chunkserver ↔ Client (data) | TCP |
9424 | CSTOCS | Chunkserver ↔ Chunkserver (replication) | TCP |
9425 | CGI / Admin | Web monitor / admin interface | TCP |
9427 | uRaft | HA consensus peer messages | UDP |
9428 | uRaft status | uRaft status endpoint | TCP |
9499 | Prometheus | Metrics (PROMETHEUS_HOST) | TCP |
note
uRaft consensus and Prometheus metrics use different ports — 9427/9428 for uRaft, 9499 for metrics. Open the ports that match the roles each host actually runs, on both hosts and any firewall in between.
Key file locations
| Path | Purpose |
|---|---|
/etc/saunafs/leil-master.cfg | Master configuration |
/etc/saunafs/leil-chunkserver.cfg | Chunkserver configuration |
/etc/saunafs/leil-mount.cfg | Default client mount options |
/etc/saunafs/leil-exports.cfg | Export access control |
/etc/saunafs/leil-goals.cfg | Replication / EC goals |
/etc/saunafs/leil-hdd.cfg | Chunkserver disk list |
/etc/saunafs/leil-topology.cfg | Network topology (rack awareness) |
/etc/saunafs/leil-metalogger.cfg | Metalogger configuration |
/var/lib/saunafs/ | Master metadata and changelog |
/var/lib/saunafs-chunkserver/ | Chunkserver state |
/var/lib/saunafs-metalogger/ | Metalogger backup data |
Systemd services
| Service | Role |
|---|---|
leil-master | Master metadata server |
leil-chunkserver | Chunk storage server |
leil-metalogger | Metadata backup daemon |
leil-uraft | uRaft HA consensus daemon |
leil-cgiserver | CGI web monitor |
sudo systemctl start saunafs-master
sudo systemctl status saunafs-chunkserver
Versioning and upgrades
LeilFS uses semantic versioning (MAJOR.MINOR.PATCH). Minor and patch releases within a major version are upgrade‑ and downgrade‑compatible and can be rolled with restarts; downgrades are supported one major version back. Upgrade in the order master → shadows → metaloggers → chunkservers → clients. See Upgrade/Downgrade notes and Routine maintenance.
Resources
- Source and man pages: github.com/leil-io/leilfs — man pages under
/doc - Releases: github.com/leil-io/leilfs/releases
- Company and support: leil.io · hello@leil.io