---
title: "Deploy minimalistic-fastapi"
description: "Simple but complete and scalable FastAPI & PostgreSQL API."
category: "Starters"
url: https://railway.com/deploy/wbTudS
---

# Deploy minimalistic-fastapi

Simple but complete and scalable FastAPI & PostgreSQL API.

**[Deploy minimalistic-fastapi on Railway](https://railway.com/template/wbTudS)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/wbTudS/manifest.json

- **Creator:** Luciano Garbarino's Projects
- **Category:** Starters
- **Total deploys:** 25

## Template content

### minimalistic-fastapi-template

- **Source:** luchog01/minimalistic-fastapi-template
- **Start command:** `uvicorn api.main:app --host 0.0.0.0 --port $PORT --forwarded-allow-ips '*'`
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:16

## Documentation

## What's Included
- 🔄 Complete CRUD operations for heroes
- 📊 Async SQLAlchemy with PostgreSQL
- 🔄 Automatic Alembic migrations
- 🏗️ Clean architecture with repository pattern
- ⚠️ Custom exception handling
- 🔍 CI and testing pipeline
- 🧹 Linter setup with pre-commit hooks
- 🚂 One-click Railway deployment

## Project Structure 📁
```
api/
├── core/              # Core functionality
│   ├── config.py      # Environment and app configuration
│   ├── database.py    # Database connection and sessions
│   ├── exceptions.py  # Global exception handlers
│   ├── logging.py     # Logging configuration
│   └── security.py    # Authentication and security
├── src/
│   ├── heroes/        # Heroes module
│   │   ├── models.py      # Database models
│   │   ├── repository.py  # Data access layer
│   │   ├── routes.py      # API endpoints
│   │   └── schemas.py     # Pydantic models
│   └── users/         # Users module
│       ├── models.py      # User models
│       ├── repository.py  # User data access
│       ├── routes.py      # User endpoints
│       └── schemas.py     # User schemas
├── utils/            # Utility functions
└── main.py          # Application entry point
```


Note: Railway will automatically detect the Python requirements and set up the necessary infrastructure.

## Similar templates

- [open-excalidraw](https://railway.com/deploy/open-excalidraw) — Self-hostable collaborative drawing built on Excalidraw
- [caring-vibrancy](https://railway.com/deploy/caring-vibrancy) — Deploy and Host caring-vibrancy with Railway
- [Appsmith](https://railway.com/deploy/appsmith-1) — Low-code platform for internal tools, dashboards, and admin panels.

Open this page in a browser: https://railway.com/deploy/wbTudS