- Documentation
- Services
- Creating a Service
On this page
Creating a Service
Creating a service on Guara Cloud takes just a few minutes. Follow the steps below to get your application up and running.
Step by step
-
Open your project and click “New Service”
In the dashboard, open the project where you want to create the service and click New Service.
-
Source: name the service
Choose a name for your service (for example,
apiorweb-app). The slug is generated automatically from the name. -
Build: choose how the application is built
Pick the build method:
- GitHub (Dockerfile) — build from the repository’s Dockerfile
- GitHub (Buildpack) — automatic language detection, no Dockerfile needed
- Docker Image — deploy directly from an existing image, from a public or private registry
For GitHub, select the repository and the branch. If the GitHub App isn’t installed yet, you’ll be redirected to grant access. Also choose the service type: Web Service (listens on a port and serves HTTP traffic) or Worker (background process with no incoming traffic). Under Advanced Build Options you can set the Dockerfile path and the build and start commands.
-
Environment: set environment variables (optional)
Add the environment variables your application needs, such as
DATABASE_URL,API_KEY, orNODE_ENV. You can add or change them at any time after creation. -
Resources: set the port, endpoint, and storage
For a web service, set the port your application listens on inside the container. The default is 3000, but you can change it (for example,
8080for a Go or Java app).New web services start with the public endpoint on, with automatic HTTPS. Turn it off if the service should only be reached by other services in the project, through the private endpoint. If you need to keep files, turn on persistent storage and set the volume size and mount path.
-
Click “Create Service”
Guara Cloud builds your application image (if needed) and starts the deployment automatically.
After creation
Once the service is created, you can track the build and deployment progress directly in the dashboard. When the service is healthy, it will be accessible via the automatic URL.
You can change any of the following at any time:
- Environment variables
- Pod size and replicas, in the Resources tab
- Custom domain
- Public endpoint on or off
Next steps
- Deploy via GitHub — set up automatic deployments
- Deploy via Docker image — use a pre-built image
- Build configuration — choose between Dockerfile and Buildpack
- Deploy links — open this wizard pre-filled from a URL