Skip to main content

Pairing Your Device

Connect your device to your Admiral organization using the pairing token.

The Pairing Token​

After booting Admiral Base OS, you'll see a 5-character alphanumeric token on the device's display.

Pairing token on device screen

Important:

  • Tokens are case-sensitive
  • Tokens expire after 15 minutes
  • Each token is unique to one device
  • Reboot the device to generate a new token if needed

Adding the Device​

  1. Log in to the Admiral Dashboard
  2. Go to Devices > Add Host
  3. Enter the pairing token from your device
  4. Give it a name (e.g., "NYC-Store-Display-01")
  5. Assign the device to a Fleet
  6. Click Add Device

Your device will immediately sync with Admiral and appear in your device list.

What Happens Next​

Once paired, the device:

  • Establishes a secure connection to Admiral
  • Receives its configuration from the assigned fleet
  • Configures any fleet-level Wi-Fi networks
  • Downloads and starts the assigned workload container

Troubleshooting​

Token not accepted?

  • Verify the token is entered exactly as shown (case-sensitive)
  • Check the token hasn't expired (15-minute limit)
  • Reboot the device to generate a new token

Device not appearing online?

  • Ensure the device has network connectivity
  • Check firewall rules aren't blocking Admiral's ports
  • Verify the device's system time is synchronized

Next Steps​

Now that your device is paired, learn about Configurations to define workloads for your devices.