Skip to content
SuperAlign
Surface
Esc
↑↓navigate↵open⌘Jpreview
On this page

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: sudo on 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 | iex

The 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

Was this page helpful?