# Deploy FastAPI

Deploy a FastAPI app to Wokku with Uvicorn workers and Postgres.

Prerequisites

• A Wokku account and a connected server
• An SSH key registered for git push
• A FastAPI app with requirements.txt

1. Create the app

wokku apps:create my-fastapi-app --server my-server

2. Prepare your FastAPI app

# requirements.txt
fastapi
uvicorn[standard]
gunicorn
psycopg[binary]

Add a Procfile (assuming app is your FastAPI instance in main.py):

web: gunicorn main:app -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:$PORT

3. Set environment variables

wokku config:set my-fastapi-app ENV=production

4. Add a database (optional)

wokku addons:create postgres my-fastapi-app

Read os.environ["DATABASE_URL"] (SQLAlchemy/SQLModel/asyncpg). See
Create & Link a Database.

5. Deploy

git remote add wokku git@git.wokku.cloud:my-fastapi-app
git push wokku main

git remote add wokku git@git.wokku.cloud:my-fastapi-app
git push wokku main

Live at https://my-fastapi-app.wokku.app — docs at /docs (Swagger UI).

Custom domain

Custom Domains — SSL is automatic.

Troubleshooting

• 502 / no response — make sure the bind uses $PORT, not a fixed port.
• UvicornWorker not found — add uvicorn[standard] to requirements.txt.
• Async DB driver — use asyncpg (not psycopg) for async SQLAlchemy.

Next steps

• Logs · Production Readiness