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.

Prerequisites

Before you begin, ensure you have:

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

Configure for seenode Deployment

Application Structure

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"}

Requirements

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

requirements.txt

fastapi
uvicorn[standard]

Deploy on seenode

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 the build and start commands:

   • Build Command:

     pip install -r requirements.txt

   • Start Command:

     uvicorn main:app --host 0.0.0.0 --port ${PORT:-80}

   

   Port setting

   Our template listens on port 80 by default. If you need a different port, change it in your framework setup (e.g., adjust your uvicorn start command or how the port is read in code).

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 will be live and accessible at your service’s public URL.

   Troubleshooting

   If your deployment fails, the first place to check is the Logs tab in your seenode service dashboard. Build and runtime logs often contain valuable information for diagnosing issues.

   Port configuration mismatch

   • Templates default to port 80. Ensure your application listens on the port you set in the Configure Build & Start screen.
   • Adjust in framework config if needed (e.g., modify your uvicorn start command or how your app reads the port).
   • Seeing a 502 Bad Gateway? This often means your app is not listening on the configured port.

Starting from Scratch?

If you don’t have a FastAPI project yet:

Option 1: Use our Template (Recommended)

FastAPI Template

Deploy a minimal FastAPI application designed for zero-configuration deployment on **seenode**.

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

Next Steps

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

Set up a Custom Domain (Coming Soon)

Configure a custom domain to point to your new web service.

Connect to a Database

Instantly scaffold and connect PostgreSQL and MySQL databases