Install script
Install the scanner with a token-carrying command, so each endpoint enrolls with nobody signing in.
The Silent install tab of the console’s Downloads page builds the install command with your enrollment token inside. Run it on each endpoint as an administrator — by hand, over SSH, or through a remote-management tool — and the endpoint joins your organization on its own. For a whole fleet, see MDM. For a one-off install where someone signs in, see Install with sign-in.
Before you begin
- You have the Owner or Admin role in Surface.
- An enrollment token is active on Downloads › Silent install. If none is, click New token there to create one.
- Administrator rights on each endpoint:
sudoon macOS, Linux, and WSL, or PowerShell opened with Run as Administrator on Windows.
Copy the command
In the console, click Downloads and stay on Silent install. Under Install script, copy the command for your platform. The token shows masked on the page; Copy places the full token on your clipboard.
Run it on each endpoint
Paste the command into a shell on the endpoint. It looks like this, with your real token in place of <token>:
curl -fsSL https://superalign.ai/surface/releases/install.sh | sudo sh -s -- --enrollment-token <token>$env:SURFACE_ENROLLMENT_TOKEN="<token>"; irm https://superalign.ai/surface/releases/install.ps1 | iexThe script installs Surface as a system service and enrolls the endpoint with the token. Nobody signs in.
Verify
The endpoint appears on Endpoints within one scan interval. On the endpoint, sudo surface status shows the service running and the organization it joined.
Next steps
- MDM to roll out to the whole fleet
- Enrollment tokens to rotate or revoke the token
- Troubleshooting if an endpoint does not appear