Skip to main content

​
Login

The CLI supports two authentication methods:

​
Browser OAuth (Default)

instapods login
This opens your browser for a secure OAuth PKCE flow. After authorizing, the token is saved to ~/.instapods/config.json.

​
Email/Password

instapods login --email you@example.com --use-password
You’ll be prompted for your password. The session token is saved locally.

​
Check Current User

instapods whoami
Displays your email, user ID, and current team.

​
Logout

instapods logout
Removes the saved token from your local configuration.

​
Token Management

The CLI stores the auth token in ~/.instapods/config.json. You can also set it via environment variable: 
export INSTAPOD_TOKEN=your-token-here
This is useful for CI/CD pipelines and automation scripts.

​
Social Login

You can also sign up or log in via GitHub or Google on the web at app.instapods.com. After logging in via social auth, use instapods login (browser OAuth) to authenticate the CLI with the same account.