Skip to content

Deploy FastAPI App on Seenode | FastAPI Hosting & Deployment Guide

This guide will walk you through deploying your existing FastAPI application on seenode using Uvicorn as the ASGI server.

Before you begin, ensure you have:

  • A seenode account at cloud.seenode.com
  • Git configured on your machine
  • Existing FastAPI project ready to deploy

Ensure your project has a main.py file and a requirements.txt. seenode will look for an app instance in your main.py file.

main.py
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
return {"message": "Hello from FastAPI"}

Your requirements.txt should include fastapi and an ASGI server like uvicorn for production:

requirements.txt
fastapi
uvicorn[standard]
  1. Push to Git

    Commit your project and push it to GitHub or GitLab.

  2. Create a Web Service

    From the

    seenode Dashboard

    , create a new Web Service and connect the Git repository for your FastAPI application.

  3. Configure Build & Start

    seenode automatically detects a Python project. Configure:

    • Build Command:
      pip install -r requirements.txt
    • Start Command:
      uvicorn main:app --host 0.0.0.0 --port 80
    Configure Build & Start: Port field

    The Port field starts empty—set it during setup to the value your app uses (for example, 80). Ensure your application binds to the same port (for example, --port 80). Do not rely on a PORT environment variable; seenode routes using the configured Port input.

  4. Choose Pricing Tier

    Select your preferred instance size and click Create Web Service.

  5. Deploy

    Click Create Web Service and watch logs until your web service is live.

  6. Success

    Once complete, your API is live and accessible at your service’s public URL.

If you don’t have a FastAPI project yet:

Option 1: Use our Template (Recommended)

Option 2: Create from FastAPI Docs + seenode Setup

Follow the official FastAPI documentation to create a new project, then return here for seenode-specific deployment steps.

seenode-Specific Setup Steps:

  1. Create main.py with FastAPI app
  2. Add requirements.txt with FastAPI and Uvicorn
  3. No additional configuration needed

Now that your API is live, here are some recommended next steps: