Deploy with the dashboard
Create and manage services visually, step by step.
The dashboard is the visual path to everything Guidal does. It is the fastest way to explore the platform and to make one-off changes; for repeatable deploys see Deploy with the CLI.
Create a service
- Sign in and choose the project you want to deploy into, using the project selector in the top navigation.
- In the navigation pane, choose Services.
- Choose Create service.
- For Source, enter the container image reference you want to run, for example
ghcr.io/your-org/your-app:v1. - For Name, enter a name unique within the project. This becomes part of the service's URL.
- For Port, enter the port your application listens on. This is the port inside the container, not a public port.
- Expand Environment variables and add any configuration your application needs at startup.
- Choose Create.
The service appears in the list with its status. A first deploy takes longer than later ones because the image has to be pulled.
Watch a deploy
- In the navigation pane, choose Services.
- Choose the service name to open its detail page.
- Choose the Deployments tab to see deploy history and the status of the current one.
- Choose the Logs tab to follow application output as it starts.
If the service does not reach a running state, the logs almost always name the reason. Troubleshooting covers the common causes.
Update configuration
- Open the service and choose the Environment tab.
- Choose Edit.
- Add, change or remove variables.
- Choose Save.
Configuration changes take effect on the next deploy, so the running instance keeps its current values until it restarts.
Scale a service
- Open the service and choose the Scaling tab.
- Set the number of replicas you want.
- Choose Save.
Your plan caps the maximum replicas per service — see Plans, billing and limits.
Roll back
- Open the service and choose the Deployments tab.
- Find the deployment you want to return to.
- Choose Roll back on that row.
- Confirm.
Guidal redeploys the image from that deployment. Rolling back changes the running code, not your environment variables — if a bad deploy also changed configuration, revert that separately on the Environment tab.
Attach a database
- In the navigation pane, choose Databases.
- Choose Create database, pick the engine, name it, and choose Create.
- When it reports as running, open it and choose Link to service.
- Select the service that should receive the connection string.
Linking passes credentials to the service as an environment variable, so they never need to be copied by hand.
Add a domain
- In the navigation pane, choose Domains.
- Choose Add domain.
- Enter the hostname and select the service it should route to.
- Choose Add. The dashboard shows the DNS record to create at your provider.
- Create that record, then choose Verify.
Once verification succeeds, a TLS certificate is issued automatically. Custom domains require a Pro or Team plan.