Prerequisites
Before your backend can go live, complete these steps: server setup (create a server and assign it to the project) and domain setup (for the production API domain).
Your backend (NestJS, FastAPI, or Laravel) runs as a Docker container on your server – together with the database (MySQL) and auxiliary services like phpMyAdmin.
How the deployment works
The flow is the regular Git workflow:
- Merge to
main→ the pipeline builds the Docker image (build-docker). - Dev automatically:
publish-docker-devwrites the new image tag into the dev configuration; the deployment runs to the server via Ansible. - Prod with one click: the manual
publish-docker-prodjob releases the same state for production.
You manage environment variables and secrets per environment via the gitops-configuration repository – see Working with environment variables.
Your backend’s URLs
| Environment | URL |
|---|---|
| Dev | backend.dev.<project>.<organization-domain> – assigned automatically |
| Prod | Your own API domain from the project configuration |
| phpMyAdmin (dev) | phpmyadmin.dev.<project>.<organization-domain> |
See also
- Operations – logs, releases, and rollback.
- Error tracking – backend errors in Sentry.