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

Loading code block...

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

Loading code block...

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.

Loading code block...

Related