Filestor
All docs

Install the Filestor agent on Linux

Get your local files into Filestor in three steps. The installer does the download, signature check, enrollment, and service setup for you — you just paste one command.

Heads up: when prompted, you'll need to enter your sudo password once so the agent can survive logout. If you skip it the agent still works — it just 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) — most Intel/AMD machines
  • Linux (arm64) — Raspberry Pi 4/5, ARM servers, AWS Graviton, etc.

You'll 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 / status commands when it's 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 — leave the window open or wire it into your own service manager.

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 (e.g. Alice's Documents), and enter the path on your machine (e.g. /home/alice/Documents). It now shows up as a volume with an AGENT badge in Explorer.

Done.

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 (comma-separate multiples), then run the script.

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 wasn't enabled — that requires sudo and the installer skips it if sudo isn't 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 re-used an old (already consumed) token. Generate a new token and re-run the installer.

Advanced: manual install

If you'd rather not run a generated shell script, the Direct download links disclosure under the installer buttons shows the raw URL and SHA-256 of each release. Then:

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. Config file lives at ~/.config/filestor-agent/config.json (mode 0600).