Skip to content
Reoclo Docs

Application Groups

Application groups let you organize related applications that deploy from the same repository. When you push to a shared repo, all applications in the group can be deployed together with a single action.

When to Use Groups

Section titled “When to Use Groups”

Groups are useful when you have a monorepo with multiple services:

my-platform/
  api/           -> api application
  web/           -> web application
  worker/        -> worker application
  docker-compose.yml

Each service has its own Dockerfile and Reoclo application, but they all live in the same repository. A group lets you deploy all of them at once when you push.

Creating a Group

Section titled “Creating a Group”
  1. Navigate to Application Groups in the sidebar
  2. Click Create Group
  3. Configure:
    • Name: descriptive label (e.g., “Platform Services”)
    • Repository: the shared repository all member apps deploy from
    • Server: optionally set a shared deployment target
    • Auto-deploy: enable to deploy all members on git push (default: on)
  4. Click Create

Adding Applications to a Group

Section titled “Adding Applications to a Group”

When creating or editing an application, select the group it belongs to. The application will inherit the group’s repository if one is set.

Each application in the group has its own:

  • Dockerfile path (e.g., ./api/Dockerfile, ./web/Dockerfile)
  • Container port
  • Health check path
  • Environment variables

Deploying a Group

Section titled “Deploying a Group”

Manual group deploy

Section titled “Manual group deploy”

From the group detail page, click Deploy All. Reoclo will trigger a deployment for every application in the group simultaneously.

The deploy summary shows:

  • Total applications
  • How many were triggered
  • How many were skipped (e.g., no repository configured)
  • Individual deployment status for each app

Auto-deploy on push

Section titled “Auto-deploy on push”

If auto-deploy is enabled on the group, pushing to the shared repository triggers deployment for all member applications. Each application builds and deploys independently — if one fails, the others continue.

Managing Groups

Section titled “Managing Groups”
  • Edit: Update the name, repository, server, or auto-deploy setting
  • Delete: Deleting a group unlinks all member applications. The applications remain but are no longer grouped.

Next Steps

Section titled “Next Steps”