Bootspring
HomeGet Started

Device Management

Authorize and control CLI and desktop app access.

Overview#

Devices represent authorized CLI installations and desktop applications:

  • Each device has a unique token
  • Devices track activity and location
  • You can revoke devices to remove access

Device List#

The Devices page shows all authorized devices:

┌─────────────────────────────────────────────────────────────────────┐ │ Devices │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ 💻 MacBook Pro [Current] [Revoke] │ │ │ │ CLI v1.2.0 • darwin arm64 │ │ │ │ San Francisco, US • Active now │ │ │ │ Sessions: 45 this week │ │ │ └──────────────────────────────────────────────────────────────┘ │ │ │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ 🖥️ Windows Desktop [Revoke] │ │ │ │ CLI v1.2.0 • win32 x64 │ │ │ │ New York, US • Last active: 2 hours ago │ │ │ │ Sessions: 12 this week │ │ │ └──────────────────────────────────────────────────────────────┘ │ │ │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ 🐧 Ubuntu Server [Revoke] │ │ │ │ CLI v1.1.0 • linux x64 │ │ │ │ AWS us-east-1 • Last active: 3 days ago │ │ │ │ Sessions: 8 this week │ │ │ └──────────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘

Device Details#

Click a device to view details:

Overview#

FieldDescription
NameDevice hostname or custom name
TypeCLI, Desktop, or Other
PlatformOperating system
ArchitectureCPU architecture
CLI VersionInstalled CLI version
LocationApproximate location
CreatedFirst authorization date
Last ActiveMost recent activity

Activity#

  • Total sessions
  • Sessions this week
  • Average session duration
  • Most used commands

Access Log#

Recent authentication events:

  • Login timestamps
  • IP addresses
  • Locations

Authorizing a Device#

Using the CLI#

# Start device authorization bootspring auth login

This displays a code to enter at bootspring.dev/device.

Using the Dashboard#

  1. Run bootspring auth login on the device
  2. Note the displayed code
  3. Go to bootspring.dev/device
  4. Enter the code
  5. Confirm authorization

Authorization Flow#

CLI Browser Server │ │ │ │ POST /devices/authorize │ │ │────────────────────────────────────────────────────────▶│ │ │ │ │◀────────────────────────────────────────────────────────│ │ Device code + User code │ │ │ │ │ │ Display code to user │ │ │ "Enter code at bootspring.dev/device" │ │ │ │ │ │ User enters code │ │ │──────────────────────────▶│ │ │ │ │ │◀──────────────────────────│ │ │ Confirm device │ │ │ │ │ Poll for token │ │ │────────────────────────────────────────────────────────▶│ │ │ │ │◀────────────────────────────────────────────────────────│ │ Access token │ │ │ │ │ │ Store token locally │ │

Device Actions#

Rename Device#

Give devices meaningful names:

  1. Click device
  2. Click Rename
  3. Enter new name
  4. Save

Revoke Device#

Revoking removes all access:

  1. Click Revoke on the device
  2. Confirm action
  3. Device is immediately logged out

Note: You cannot revoke your current device from the dashboard.

Revoke All Devices#

In emergency situations:

  1. Go to Settings > Security
  2. Click Revoke All Devices
  3. Confirm action
  4. All devices except current are revoked

Device Limits#

PlanMax Devices
Free2
Pro5
Team20 per user
EnterpriseUnlimited

Security Features#

Suspicious Activity Detection#

Bootspring monitors for:

  • Logins from new locations
  • Multiple failed attempts
  • Unusual usage patterns

You'll receive alerts for suspicious activity.

Automatic Revocation#

Devices may be auto-revoked for:

  • 90 days of inactivity
  • Security policy violations
  • Account suspension

Location Tracking#

Location is determined from IP address:

  • City and country
  • Not precise coordinates
  • Can be disabled in settings

CLI Commands#

1# List devices 2bootspring auth devices 3 4# Show current device 5bootspring auth status 6 7# Logout (revokes current device) 8bootspring auth logout 9 10# Logout from all devices 11bootspring auth logout --all

Troubleshooting#

Device Authorization Fails#

Code expired: Codes expire after 15 minutes. Run bootspring auth login again.

Code invalid: Ensure you're entering the code exactly as shown.

Network issues: Check your internet connection.

Device Limit Reached#

Revoke unused devices:

  1. View device list
  2. Identify inactive devices
  3. Revoke them
  4. Try authorizing again

Device Shows Wrong Location#

Location is based on IP address and may be inaccurate:

  • VPN usage affects location
  • ISP routing can cause misattribution
  • Not a security concern

API Integration#

See Devices API for programmatic access.

1# List devices 2curl https://api.bootspring.dev/v1/devices \ 3 -H "Authorization: Bearer bs_xxx" 4 5# Revoke device 6curl -X DELETE https://api.bootspring.dev/v1/devices/dev_abc123 \ 7 -H "Authorization: Bearer bs_xxx"

Related#