Guidal
Sign in

Quickstart

Get an application running on Guidal Cloud in about five minutes.

This is the shortest path from a fresh account to a running application with a public URL. It uses the command line; the same steps are available in the dashboard and through an AI agent.

Before you start

You need a Guidal account and a container image that listens on a port. If you do not have an image handy, the public nginxdemos/hello image works for a first run.

1. Install the CLI

bash
pip install guidal

Verify it is on your path:

bash
guidal version

2. Sign in

bash
guidal login

This opens your browser to complete sign-in and stores a token locally. Confirm it worked:

bash
guidal whoami

3. Pick a project

Every service lives inside a project. New accounts start with one. List what you have:

bash
guidal projects list

Create one if you need to, then make it the active project so later commands do not need --project:

bash
guidal projects create my-app
guidal projects switch my-app

4. Deploy a service

bash
guidal services create web \
  --image nginxdemos/hello \
  --port 80

Guidal pulls the image, starts it, and assigns a URL. Watch it come up:

bash
guidal services list

5. Open it

bash
guidal services get web

The output includes the service URL. Open it in a browser and you should see the running application.

Nothing to see yet?

A first deploy takes a short while to pull the image. If the service stays in a non-running state, check its logs with guidal logs query --service web — most first-deploy problems are a wrong port or a missing environment variable.

What next