Service Groups

Service groups let you organize related applications together and define their dependencies. This is useful for managing microservice architectures where multiple services work together as a system.

Creating a Service Group

1. Navigate to Service Groups in the sidebar
2. Click New Group
3. Enter a display name and description
4. The group is created and ready to accept members

Adding Applications

Open your service group and add applications as members:

1. Click Add Application in the group detail page
2. Select applications from your organization
3. For each member, optionally set:
   • Role — The application’s purpose within the group (e.g., “API”, “database”, “cache”, “worker”)
   • Dependencies — Which other group members this application depends on
   • Preview sharing — Whether this service participates in group preview environments

Defining Dependencies

Dependencies describe how services within the group communicate:

• API → Database — The API service depends on the database
• Frontend → API — The frontend calls the API
• Worker → Queue — The worker processes messages from a queue

These dependencies are used for:

• Ordering deployments during preview environment creation
• Visualizing the service architecture
• Coordinating approval workflows

Preview Environments

Service groups integrate with Preview Environments. When creating a preview for a service group, you can deploy all member applications together in a single isolated environment, with their dependencies automatically configured.