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.

1
from fastapi import FastAPI
2

3
app = FastAPI()
4

5
@app.get("/")
6
def read_root():
7
    return {"message": "Hello from FastAPI"}

Requirements

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

1
fastapi
2
uvicorn[standard]

Deploy on seenode

::::tip[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

• There is no default port. Ensure your application listens on the port you set in the Configure Build & Start screen.
• Adjust in framework config if needed (for example, 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)

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: