DocsGetting StartedAuthentication

Authentication

How to authenticate with Deployzy.

There are three ways to authenticate with the CLI:

Opens your browser to sign in with Google:

bash
deployzy login

This saves a JWT token to ~/.deployzy/authtoken automatically. You only need to do this once.

2. API key

Get an API key from your dashboard, then:

bash
deployzy authtoken sm_live_your_key_here
  • API keys are useful for:
  • CI/CD pipelines
  • Shared machines
  • Programmatic access via SDKs

3. Email + password

bash
deployzy login:email --email you@example.com --password yourpassword

How it works

  • deployzy login saves a JWT token (expires in 24 hours, auto-refreshes)
  • deployzy authtoken saves an API key (never expires unless revoked)
  • Both are stored at ~/.deployzy/authtoken
  • The CLI reads this file automatically on every command

For SDKs

Pass your API key directly:

typescript
import { Deployzy } from '@deployzy/sdk';
const client = new Deployzy({ authtoken: 'sm_live_...' });
python
from deployzy import Deployzy
client = Deployzy(authtoken="sm_live_...")