Note: When you run the install command (using docker or locally), a .env file will be created automatically based on env.template

Helpful commands

Please, check all available commands in the Makefile for more information.

Uvicorn settings

Uvicorn is an ASGI web server implementation for Python and you can configure it overriding these values on the settings.conf file.

Note: The default value of these configs are available on run.py.

Production Docker Images

This project provides two production-ready Docker images with a multi-stage build approach:

Standard Production Image (production)

Based on python:3.14-slim-bookworm, this is a minimal image without Poetry or development dependencies.

make docker/image/build

Distroless Production Image (production-distroless)

An ultra-minimal image using Chainguard for maximum security and smallest footprint.

make docker/image/build/distroless

Why Chainguard?

• Minimal attack surface: No shell, package managers, or unnecessary tools
• Reduced CVEs: Significantly fewer vulnerabilities compared to traditional base images
• Smaller size: Only essential runtime components included
• Signed images: Cryptographically signed with Sigstore for supply chain security
• SBOM included: Software Bill of Materials for compliance and auditing

Trade-offs:

• No shell access for debugging (use ephemeral debug containers if needed)
• Free tier only provides :latest tag (specific version tags like 3.14.x require paid tier)

Running the distroless image:

docker run -p 8000:8000 --env-file .env fast-api-boilerplate-project:latest-distroless

For more information about Chainguard images, visit the official documentation.

Logging

This project uses a simple way to configure the log with logging.conf to show the logs on the container output console.

Settings

This project uses a simple way to manage the settings with settings.conf and ConfigParser using a config class.