Connect and enable the storage node

Register via /install (Test & connect). Success sets setupStatus connected, Status On, and enables the node.

Connect and enable the storage node

Link the installed node to the master site and put it in rotation.

Where to find it

1. On the node: https://<node-domain>/install (Connect storage node)

2. On the master: Admin → Servers → edit that server (/admin/servers/add?srv_id=...) → Edit storage server

How it works

On install, enter Main website URL, Registration token, Storage path (placeholder often /var/xfileultra-storage/Uploads), and Public URL of this nodeTest & connect.

On success the master:

  • Clears the one-time token
  • Sets setupStatus: connected, statusMode: ON, enabled: true, healthStatus: ok
  • Stores encrypted node secret; sets apiUrl / hostname from the public URL
  • Seeds SFTP ingest defaults (enabled, host from node URL, port 22, staging sftp-incoming, cap 50)

Banner moves from Waiting for connection to Connected. Test connection on the edit form refreshes health (POST .../refresh).

Register already turns the server On - you usually do not need a separate enable step unless you later set Off / Read-only.

Common problems

Still awaiting install

Token expired (regenerate), wrong main URL, storage path not writable, or public URL unreachable from the node.

"This server is already connected or the setup token was used."

Token was one-time - regenerate only works while not connected; otherwise provision a new server.

/install disabled

Node already connected - manage it from Admin → Servers.

Related