Skip to content

Edge install

One command to install and enroll your edge device. The installer handles everything automatically.

Quick Install
curl -fsSL https://netiium.com/install | sh

This installs the sidecar, verifies signatures, and prompts you to log in at control.netiium.com. No environment variables are needed for the public Netiium install. Private deployments should set NETIIUM_CONTROL_URL to the coordination server for their network.

Platform support

Linux (Recommended)

Native systemd support. Use the curl command above.

Windows

Windows uses the same sidecar flow as Linux. Enroll it against the coordination server URL assigned to your network.

  1. Install the Windows sidecar package.
  2. Run device login with the coordination server for your network:
netiium device-login   --control-url <your-network-coordination-server>   --out-config "C:\ProgramData\Netiium\sidecar.yaml"   --interface wg0

Replace <your-network-coordination-server> with the coordination server URL your network admin gave you.

macOS

macOS uses the same sidecar flow as Linux. Enroll it against the coordination server URL assigned to your network.

  1. Install the macOS sidecar package.
  2. Run device login with the coordination server for your network:
sudo netiium device-login   --control-url <your-network-coordination-server>   --out-config /etc/netiium/sidecar.yaml   --interface wg0

Replace <your-network-coordination-server> with the coordination server URL your network admin gave you.

Advanced: Auth key enrollment

For automated provisioning and unattended installs, use an auth key instead of interactive login.

With auth key
NETIIUM_CONTROL_URL="<your-network-coordination-server>" \
NETIIUM_AUTH_KEY="ak_..." \
curl -fsSL https://netiium.com/install | sh

Generate auth keys in the Netiium control panel under Settings → Auth Keys.

Advanced: Environment variables

Most users do not need these. Environment variables are only required for private deployments or special configurations.

Show all environment variables
NETIIUM_AUTH_KEYAuth key for unattended installs
NETIIUM_SKIP_ENROLLInstall without enrolling
NETIIUM_FORCE_ENROLLRe-enroll existing device
NETIIUM_CONTROL_URLPrivate control plane / coordination URL
NETIIUM_UPDATE_PUBKEY_B64Custom update signing key

Need help?

Contact support at support@netiium.com or visit the control panel.