Managing Services
After creating a service, you can control its state directly from the dashboard. This page explains the available operations and what happens with each one.
Starting a service
If a service is stopped, you can start it by clicking Start on the service page. Guara Cloud will recreate the container with the last deployed image and the current configuration.
Stopping a service
When you stop a service, the container is terminated and the service URL stops responding. Resources (CPU and memory) are released.
To stop a service:
- Go to the service page in the dashboard
- Click Stop
- Confirm the action
Stopping a service does not delete your data. Environment variables, deployment history, persistent volumes, and configurations are preserved. You can restart the service at any time.
Restarting a service
Restarting a service terminates the current container and creates a new one with the same configuration. This is useful for:
- Applying changes that require a restart
- Resolving temporary issues
- Clearing in-memory state
If the service has multiple replicas, the restart is performed gradually (rolling restart). Each replica is restarted one at a time, ensuring the service remains available throughout the process.
Deleting a service
To delete a service:
- Go to the service page in the dashboard
- Click Settings
- In the Danger Zone section, click Delete Service
- Confirm by typing the service name
When you delete a service:
- The container is terminated immediately
- All deployments and build history are removed
- Persistent volumes are deleted
- The default subdomain is released
- Custom domains are unlinked
Renaming a service
You can change a service’s display name in the settings. However, the default subdomain does not change after renaming. The subdomain is set at creation time and remains the same for the service’s entire lifetime.
For example, if you created a service named api and later renamed it to backend, the default URL will still be api-your-project.guaracloud.com.
Operations summary
| Operation | Effect | Reversible? |
|---|---|---|
| Start | Recreates the container and brings the service online | Yes |
| Stop | Terminates the container and releases resources | Yes |
| Restart | Terminates and recreates the container (rolling if replicas) | Yes |
| Delete | Permanently removes everything | No |
| Rename | Changes display name (URL does not change) | Yes |