- Documentation
- Getting Started
- Quickstart
Quickstart
Follow these steps to get your first application up and running on Guara Cloud.
Prerequisites
- A GitHub or Google account to sign in, or an email address to receive the login link.
- A repository with your application (any language that runs in a container).
Your first deploy
-
Sign in to Guara Cloud
Go to guaracloud.com and click Sign In. You can log in with your GitHub or Google account, or with a one-time email link. Every new account starts with a free trial, no credit card required.
-
Pick a project
Your account already has a default project, ready for services. If you’d rather keep things separate, click New Project and give it a name. A project is the unit that groups your services.
-
Create a service
Inside the project, click New Service. Name the service and, in the Build step, choose GitHub (Dockerfile) or GitHub (Buildpack), connect your repository, and select the branch you want to deploy (for example,
main). -
Configure and deploy
Add environment variables if needed. In the Resources step, set the port your application listens on (for example,
3000for a Node.js app). Click Create Service. -
Access your application
In a few minutes, your service will be live. Access it via the automatic URL:
https://your-service-your-project.guaracloud.com
Example: deploying a Node.js app
If you have a simple Express app, just include a Dockerfile in the root of your repository:
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
EXPOSE 3000
CMD ["node", "server.js"]
Connect the repository in Guara Cloud, set the port to 3000, and click Create Service. That’s it.