Skip to content
FastAPI Cloud Logo FastAPI Cloud Docs

Login Command

The fastapi login command authenticates you with FastAPI Cloud. 🚀

This allows you to deploy applications and manage your FastAPI Cloud resources from the CLI.

Usage

Section titled “Usage”
Terminal window
fastapi login

The command will automatically open your browser to complete the authentication.

What Happens When You Login

Section titled “What Happens When You Login”

When you run fastapi login, the CLI will:

  • Start a device authorization flow
  • Open your browser to the FastAPI Cloud login page
  • Wait for you to authorize the device
  • Store your authentication credentials locally

Where Credentials Are Stored

Section titled “Where Credentials Are Stored”

Your authentication credentials are stored locally on your system in a configuration file.

These credentials are system-wide for the current user, not project-specific. Once logged in, you can deploy any FastAPI application without logging in again.

Login vs Project Configuration

Section titled “Login vs Project Configuration”

It’s important to understand the difference:

  • fastapi login - System-wide authentication (run once)
  • .fastapicloud directory - Project-specific configuration (created by fastapi deploy)

You need to be logged in to deploy, but each project has its own deployment configuration.

Important Notes

Section titled “Important Notes”

You only need to log in once. The credentials persist across terminal sessions until you explicitly log out.

Troubleshooting

Section titled “Troubleshooting”

Authorization Timeout

Section titled “Authorization Timeout”

If you don’t complete the authorization in time, the process will timeout. Simply run fastapi login again.

Section titled “Related Commands”
  • fastapi cloud logout - Log out from FastAPI Cloud
  • fastapi cloud whoami - Check your current authentication status
  • fastapi deploy - Deploy an application (requires login)