Skip to content

Deployment Overview ​

Public Summary ​

Obrok uses Docker Compose for both development and production, with Nginx as production reverse proxy and Certbot for SSL renewal.

Internal Details ​

Environment Shapes ​

  • Development: client, docs, api, osrm, db with exposed ports and live mounts.
  • Production: nginx, certbot, api, osrm, db with internal networking and restricted DB exposure.

Docs Hosting Target ​

Documentation should be built by VitePress and served at docs.obrok.net as static files on the same VPS infrastructure.

Source Anchors ​

PathRelevance
docker-compose.dev.ymlDev service topology
docker-compose.prod.ymlProd service topology
apps/nginx/nginx.confReverse proxy and static serving
.github/workflows/deploy.ymlRelease-triggered deployment
init-ssl.shFirst-time SSL bootstrap
init-route-data.shOSRM map data preparation

Risks and Trade-offs ​

  • Single VPS deployment reduces complexity but centralizes failure domain for app and docs workloads.

Obrok engineering documentation.