sudo password once so the agent can survive logout. If you skip it, the agent still works, but it stops when you log out.1. Get your install command
In Filestor: Storage - Agent - enter a name - Generate enrollment token. A card appears with Download installer buttons. Click the one for your Linux CPU:
- Linux (x86_64) for most Intel and AMD machines.
- Linux (arm64) for Raspberry Pi 4/5, ARM servers, and AWS Graviton.
You will get a small file named filestor-agent-install.sh.
2. Run it on your Linux machine
sh ~/Downloads/filestor-agent-install.sh
The script will, in order:
- Download the signed agent binary into
~/.local/bin/. - Verify the SHA-256 hash.
- Enroll automatically with the token baked into the script.
- Install a user systemd service that auto-starts on boot and restarts on failure.
- Print logs and status commands when it is done.
On any modern Linux desktop or server, the agent is now running in the background and you can close the terminal. On systems without systemd, the script falls back to running the agent in the foreground.
3. Verify in Filestor
In Storage - Agent, the agent flips from "Pending enrollment" to Online within a second, with a version badge like v1.2.3 linux/amd64.
Click Attach as root on that row, give the root a name, and enter the path on your machine, such as /home/alice/Documents. It now shows up as a volume with an AGENT badge in Explorer.
Common questions
The installer uses ~/Documents by default. How do I change that?
Open the downloaded filestor-agent-install.sh in any text editor and change ALLOWED_ROOTS="$HOME/Documents" near the top to whatever paths you want. Use commas for multiple paths.
How do I check the agent is running?
systemctl --user status filestor-agent journalctl --user -u filestor-agent -f
How do I uninstall?
systemctl --user disable --now filestor-agent rm ~/.config/systemd/user/filestor-agent.service rm ~/.local/bin/filestor-agent ~/.local/bin/filestor-agent.bak rm -rf ~/.config/filestor-agent
Then delete the agent from Storage - Agent in Filestor.
The agent shows as Offline after I rebooted.
Most likely loginctl enable-linger was not enabled. That requires sudo, and the installer skips it if sudo is not available. Run it once:
sudo loginctl enable-linger "$USER" systemctl --user restart filestor-agent
The status says "Pending enrollment" forever.
You generated a token but never ran the installer, or you reused an old token. Generate a new token and rerun the installer.
Advanced: manual install
If you would rather not run a generated shell script, the Direct download linksdisclosure under the installer buttons shows the raw URL and SHA-256 of each release.
curl -fsSL -o filestor-agent <url> echo "<sha256> filestor-agent" | sha256sum -c - chmod +x filestor-agent ./filestor-agent enroll \ --server <ws-url> --token <token> --allowed-roots ~/Documents ./filestor-agent run # or wire it into systemd yourself
Agent flags: --server, --token, --allowed-roots, --config, --update-interval. The config file lives at ~/.config/filestor-agent/config.json with mode 0600.