Install FF1 Core

FF1 Core is the forwarding engine installed on each node (systemd service ff1-agent). One-click provisioning from the console via SSH is recommended; manual install is also supported.

Option A: One-click SSH provisioning from the console (recommended)

1. Sign in to the Master console → Nodes → Add Node
2. Enter the SSH address, port, and root password or key
3. Click Test SSH to confirm connectivity
4. Submit and watch the progress: Prepare → SSH connected → Install FF1 Core → Done
5. Once the node is online, you can select it in Forward Rules

Master issues a token for the node, runs the install remotely, and registers it.

Option B: Manual install

On the node, run as root (replace <master> with your Master address, and <token> with the node token generated in the console):

curl -fsSL <master>/install/agent.sh | sudo bash -s -- --master <master> --token <token>

The script downloads the FF1 Core build for the matching architecture, writes the ff1-agent systemd service, and starts it with these environment variables:

FF1_MASTER_URL=<master>
FF1_NODE_TOKEN=<token>

After install:

systemctl status ff1-agent

Uninstall:

curl -fsSL <master>/install/agent.sh | sudo bash -s -- --uninstall

Notes

• FF1 Core must be able to actively connect to Master (WebSocket + HTTP/HTTPS); inbound-only machines that cannot make outbound connections are not supported
• The node binary is pulled from Master’s /dl/ by default and stays aligned with the Master version
• After a reinstall or a change of Master address, the old node record may need to be taken offline manually in the console

FAQ

Q: SSH test passes but provisioning fails? A: Usually the node cannot reach the internet to download, or the disk is full — check outbound connectivity and disk space.

Q: Node is online but forwarding does not take effect? A: Check the config delivery queue and confirm no delivery task has failed.

Next steps

• Nodes
• Forward Rules