Deploy your first app
Get a container live on a public HTTPS URL in five steps. The portal generates the deploy workflow for you, so there is nothing to upload and no passwords to paste.
Get your app live on a public HTTPS URL in five steps. You bring a GitHub repo; the portal does the rest, and it even generates the deploy workflow with every value already filled in.
Before you start
You'll need:
- A GitHub repo with your app's code (and a Dockerfile, which we give you if you don't have one yet).
- To be signed in at app.alawadi.cloud with Google — new accounts can claim a one-time $5 trial credit from the portal, enough to try a small deploy right away.
- For anything beyond the trial credit, a redeemed voucher so your balance can keep covering the app.
Create a project and an app. Open Cloud Studio, pick Application as
what you want to deploy, give your app a Name, and choose public access
(a managed domain and TLS come with it). Cloud Studio creates the Project and
boots your app right away on a placeholder, with a public *.alawadi.cloud URL
and TLS. There's no image to upload yet. You'll point it at your real image in
the next steps.
Create a private registry. In Registries → Create registry, enter a Name and link it to your project. The registry address is assigned for you, so wait for its status to turn ready. Your images will live here.
Authorize your GitHub repo with two quick forms on the registry's page, both using GitHub OIDC (no curl, no keys, no password):
- Push setup: enter your
owner/repoand click Configure trust. This lets your repo push images. - CI workflow templates: pick your runtime, choose your app under Deploy target, and click Configure deploy trust. This lets your repo deploy.
You need both, because pushing an image doesn't deploy it on its own.
Copy the workflow and push. Click Copy workflow. You get a ready
.github/workflows/deploy.yml with the image address, your app's ID, and the
OIDC login already filled in. The only thing to adjust is the build settings for
your stack, shown as comments in the file (no Dockerfile? expand Supporting
Dockerfile and copy ours). Save it to your repo, commit, and push to main.
Open your app. When the rollout finishes and the status is running, open
the *.alawadi.cloud URL from your app's page. That's your image, live.
Watching the rollout
After you push, follow progress on your app's page: Recent deployments, the timeline, and live logs.
Need more detail?
- Every registry and trust field: Connect a registry
- What your image must do (listen on
8080, run non-root): Container requirements - Scripting the same deploy from CI over the API: Deploy from GitHub via OIDC