Upgrade & License Management

Keep your CLI up-to-date and manage your device registrations with built-in commands.

Updating the CLI

Run the built-in upgrade command to check for and install the latest version:

localbridge upgrade

Local Bridge v1.0.5

Checking for updates...
[!] New version available: v1.0.5 -> v1.0.6

Downloading update...
[OK] Checksum verified
[OK] Successfully upgraded to v1.0.6
    Restart any running shares to use the new version.

How it works:The CLI contacts our API backend, which validates your license and returns a time-limited download URL along with a SHA-256 checksum. The binary is downloaded to a temporary file, its checksum is verified against the expected value, and then it is atomically swapped with the existing binary. If the download fails or the checksum doesn't match, your original binary is completely untouched.

Checking License Status

View your current license and verification status:

localbridge status

License: ABC1234...XY9Z
Email: [email protected]
Last Verified: 3 hours ago
Next Check: in 21 hours

Device Reset

If you've hit your device limit or switched machines, use reset to clear all registered devices except the current one. You will be prompted to enter your license key for security:

localbridge reset

This will remove ALL other devices from your license.
Your current device will remain active.

Enter your license key: ****

Resetting devices...

[OK] Reset complete!
    Removed: 3 device(s)
    Remaining: This device only (1 of 10)

This is useful when migrating to a new machine or cleaning up old CI runners that are no longer in use.

Uninstalling

To completely remove Local Bridge from your system:

localbridge uninstall

This will remove the binary from your PATH and clean up the Local Bridge data directory. If background shares are currently running, the binary file is left in place but PATH and cache are still cleaned.