Deploy your first app

Deploy a public container image, open it at its default URL, read what the deployment did, and delete it again, in about ten minutes.

Last updated 18 November 2026View as Markdown

The tutorial runs the public image docker.io/library/nginx:1.27-alpine, which listens on port 80. Replace app-id with the id the create step returns, and deployment-id with the id the deploy step returns.

Prerequisites

  • Permission for deploy:CreateApp, deploy:DeployApp, deploy:DescribeApp and deploy:DeleteApp. The AdministratorAccess policy has them.
  • For the CLI: dcloud installed and signed in.

Important

The first deployment creates a machine, and you pay for it per started hour until you delete the app in Clean up.

Step 1: Create the app

  1. Open Apps, then choose Create app.
  2. Under What to run, choose A container image.
  3. If your registry already holds images, for Image from, choose From somewhere else.
  4. For Image reference, enter docker.io/library/nginx:1.27-alpine.
  5. Choose Continue.
  6. For Name, enter my-app.
  7. For Container port, keep 80. The console sets it for an nginx image; for another image, enter the port it listens on (the console's default is 8080).
  8. For Machine size, keep the default, then choose Continue.
  9. Under Rollout, keep Deploy immediately selected. Cleared, the app is created without a deployment.
  10. Choose Create and deploy. The app page opens and the first deployment starts.

Step 2: Deploy it and wait

  1. Open the app's Deployments tab. Activity lists each step as it happens: the machine being created, the image pulled, the health check, the domain moved.
  2. Wait until the status reads Live. A first deployment installs the machine and takes a few minutes.

Step 3: See it live

  1. On the app page, choose Open. The nginx welcome page loads at the app's default URL, over HTTPS.

Clean up

Delete the app so that its machine stops costing money.

  1. Open the app's Danger zone tab.
  2. Choose Delete app, enter the app's name to confirm, and confirm. The app list shows it as deleting until everything it created is gone.

Next steps

Did this page help you?