Skip to Content
A8n Documentation v1.0.0 is released 🎉

FastAPI App

Use this guide for a FastAPI service that should run as one application container.

Recommended deployment mode: Monolith. This works well for API services that expose one HTTP entry point.

What Users Should Prepare

  • A FastAPI repository with a working uvicorn or gunicorn startup command
  • A Dockerfile with Python dependencies installed
  • A known port such as 8000
  • Required secret values such as DATABASE_URL or API tokens

Dashboard Deployment Flow

Create the Project

Connect the FastAPI repository in Autonomous and start a new monolithic project.

Configure Port and Build Inputs

Set the Dockerfile path, startup port, and any subfolder paths if the app is not at repository root.

Add Secrets and Runtime Variables

Store all environment variables through Autonomous so Vault injects them safely at deploy time.

Deploy and Inspect Health

Deploy the service and verify pod health, logs, and a basic API or health endpoint.

Common User Mistakes

  • The app binds to 127.0.0.1 instead of 0.0.0.0
  • The declared container port does not match the FastAPI runtime port
  • The image builds, but runtime dependencies are missing in the final container layer