Services Overview
A service is the fundamental deployment unit in Guara Cloud. It represents your application running in the cloud — whether it is an API, a website, a worker, or any other containerized process.
What is a service?
Each service corresponds to a deployed application. You can have multiple services within the same project, each with its own configuration, environment variables, and domain.
When you create a service, it automatically gets:
- HTTP endpoint — a public URL in the format
your-service-your-project.guaracloud.comwith HTTPS included - Compute resources — CPU and memory allocated according to your project’s plan
- Environment variables — configurations and secrets injected into your container
- Default domain — an automatic
*.guaracloud.comsubdomain with a free SSL certificate
How services work
Services run in containers. You can provide a Dockerfile in your repository or let Guara Cloud automatically detect your application’s environment using Buildpacks. You can also deploy directly from a pre-built Docker image.
Each service operates independently. This means you can deploy, stop, restart, or scale a service without affecting other services in the same project.
Service lifecycle
A service goes through the following stages:
- Create — you define the name, source (GitHub or Docker image), and initial configuration
- Configure — you add environment variables, set the port, and adjust resources
- Deploy — Guara Cloud builds the image (if needed) and puts the service online
- Healthy — the service is running and responding to requests
What you can do with services
- Deploy via GitHub — connect your repository and get automatic deployments on every push
- Deploy via Docker image — use a pre-built image from any public registry
- Environment variables — manage configurations and secrets securely
- Scaling — adjust replicas, CPU, and memory based on demand
- Persistent storage — volumes that survive service restarts
- Custom domains — point your own domain to any service