FastAPI is a modern, async web-framework for building APIs with Python 3.6+ making use of type hints. It is a microframework, in many ways quite similar to Flask and uses the MIT license.


For this guide you should be familiar with the basic concepts of


We are creating a very basic proof-of-concept API that will do a calculation and return the result as valid JSON.

Create application directory and files

[isabell@stardust ~]$ mkdir ~/fastapi
[isabell@stardust ~]$

Create a file ~/fastapi/ with the following content:

#!/usr/bin/env python3.11
import fastapi
import uvicorn

api = fastapi.FastAPI()

def calculate():
  answer = 24 + 18
  return {'answer': answer}

# To test this app locally, uncomment this line:
#, host="localhost", port=8000)

Python Virtual Environment

To install the packages your application depends on, you want to use a virtual environment that is isolated from the system’s Python packages. FastAPI requires Python 3.6+ but we are going to use the latest version available, which is currently Python 3.11:

[isabell@stardust ~]$ cd ~/fastapi
[isabell@stardust fastapi]$ python3.11 -m venv venv
[isabell@stardust fastapi]$ source venv/bin/activate
(venv) [isabell@stardust fastapi]$

In your virtual environment, install the dependencies we are using in

(venv) [isabell@stardust fastapi]$ pip install fastapi uvicorn
(venv) [isabell@stardust fastapi]$


You can already check if your application is working by uncommenting the line and executing python in the virtual environment. Open a second ssh connection and get the output with curl localhost:8000

While uvicorn handles the asynchronous side of FastAPI, we want gunicorn as a well-tested and production-ready solution to run and manage multiple uvicorn workers. Install it with two dependencies in your virtual environment:

(venv) [isabell@stardust fastapi]$ pip install gunicorn uvloop httptools
(venv) [isabell@stardust fastapi]$

You can deactivate the virtual environment context like this:

(venv) [isabell@stardust fastapi]$ deactivate
[isabell@stardust fastapi]$


Incoming https requests are routed through nginx to a web backend where our application server is listening. Let’s get this working:


First, we are telling gunicorn to spin up several uvicorn processes and listen on port 8000 for incoming requests. Create the config file ~/fastapi/

import os
app_path = os.environ['HOME'] + '/fastapi'

# Gunicorn configuration
wsgi_app = 'main:api'
bind = ':8000'
chdir = app_path
workers = 4
worker_class = 'uvicorn.workers.UvicornWorker'
errorlog =  app_path + '/errors.log'

This is a minimal working example based on gunicorn’s example config, you can find a comprehensive list of options here.


Test if everything is working with ~/fastapi/venv/bin/gunicorn --config ~/fastapi/ --check-config. If there is no output, you’re good.


Next, create a configuration for supervisord in ~/etc/services.d/fastapi.ini:

command=%(ENV_HOME)s/fastapi/venv/bin/gunicorn --config %(ENV_HOME)s/fastapi/

After creating the configuration, tell supervisord to refresh its configuration and start the service:

[isabell@stardust ~]$ supervisorctl reread
SERVICE: available
[isabell@stardust ~]$ supervisorctl update
SERVICE: added process group
[isabell@stardust ~]$ supervisorctl status
SERVICE                            RUNNING   pid 26020, uptime 0:03:14
[isabell@stardust ~]$

Web backend


Gunicorn is set up to run on port 8000.

To make the application accessible from the outside, configure a web backend:

[isabell@stardust ~]$ uberspace web backend set / --http --port <port>
Set backend for / to port <port>; please make sure something is listening!
You can always check the status of your backend using "uberspace web backend list".
[isabell@stardust ~]$

That’s it

This concludes the setup. Point your browser to your url and check that everything is running correctly.

Written by: Christian Macht <>