Skip to content

Development stacks

Development-stack tasks combine the optional fastapi and containers tags. The bundled stack can run an application, debugger, PostgreSQL, Adminer, and Alembic migrator through Docker Compose.

Select the database addon before using database-specific tasks.

[tool.poe.env]
COMPOSE_TYPE = "fastapi"
COMPOSE_ADDONS = "db"

See Development-stack settings for ports, compose overlays, and service configuration.

Task Description
stack-up Bring up the development stack for the application.
stack-down Bring down the development stack for the application.
reset-db Reset the database by deleting the database volume.
run-db-migrations Run database migrations.
db-shell Open a psql shell to the database container.