Skip to main content
The checkly login command authenticates with Checkly by signing up for a new account or logging in to your existing account. The CLI shows a URL and a short code. Open the URL in a browser on any device, enter the code, and log in or sign up there. The browser doesn’t have to run on the same machine as the CLI, so this also works over SSH, in containers and from AI agents.
Before using checkly login, ensure you have:
  • Checkly CLI installed
  • A web browser on any device (it doesn’t have to be the machine running the CLI)
  • Internet connection for authentication flow
No existing Checkly account is required - you can sign up during the login process.

​
Usage

The basic command initiates the login process and authenticates with your Checkly account.
Terminal
Use environment variables in environments without interactive prompts. See the Authentication section for more info.

​
Examples

Terminal

​
Options

​
Authentication Flow

The login process will:
  1. Show a URL and a code, and open your default browser on that URL when it can
  2. Wait until you have logged in or signed up in the browser
  3. Prompt for account selection if you have multiple accounts
  4. Store authentication tokens locally for future CLI usage
  5. Display confirmation with your account information
Commands that need authentication start the same login when no credentials are stored, so you don’t have to run checkly login first.

​
AI agents

When the CLI runs under an AI agent, checkly login prints a JSON line with the URL and code for the agent to pass on to you, and exits instead of waiting. After you’ve approved the login in the browser, the agent runs the command again to finish it. In CI, set environment variables instead.

​
New Users

If you don’t have a Checkly account:
  1. Click “Sign up” on the authentication page
  2. Complete account registration
  3. Return to the CLI - you’ll be automatically logged in

​
Existing Users

If you already have an account:
  1. Enter your credentials on the authentication page
  2. Complete any two-factor authentication if enabled
  3. Return to the CLI - authentication will complete automatically

​
Authentication Storage

After successful login, the CLI stores authentication tokens locally in:
  • macOS: ~/Library/Preferences/@checkly/cli/auth.json
  • Linux: ~/.config/@checkly/cli/auth.json
  • Windows: %APPDATA%\@checkly\cli\Config\auth.json
The file is plain JSON and is not encrypted. The stored tokens are used for subsequent CLI operations without requiring re-authentication.

​
Troubleshooting

​
Browser doesn’t open automatically

Open the displayed URL in a browser on any device and enter the code.

​
Logging in as a different user

Run checkly logout first, then checkly login again.

​
Multiple accounts

If you have access to multiple Checkly accounts, you’ll be prompted to select which account to use as the active account for CLI operations. You can also switch accounts later using checkly switch or checkly login --account-id <id>.