Skip to content

Projects & services

A project is a namespace. You put related services (a database, an app, a cache, a queue) into one project and manage them together. Projects show up as groups in the Canvas view and as a filter in the sidebar.

A service is one managed container (or one Docker Compose stack) that Pier supervises. Each service has:

  • A name — user-visible and unique within the project.
  • A template — the source of truth for image, ports, volumes, env vars, and healthcheck. One of database/*, service/*, application/*, or a Git source.
  • A set of env vars — encrypted at rest.
  • A list of domains — each one gets a Traefik router and a Let’s Encrypt certificate.
  • A deployment history — with one-click rollback to previous versions.

If you deploy from Docker Compose, Pier treats the whole stack as one service. Individual containers in the stack are visible and streamable for logs, but they are managed as a unit — you redeploy the whole stack, not one container.