Citadel
Getting started

Run your first Compose Stack

Paste a Compose file, deploy it, and check its services.

A Stack groups services described in a Docker Compose file. This example uses a Docker Standalone Platform and does not need a Git repository.

Create a Stack

  1. Open Stacks and select Add Stack.
  2. Name it hello-stack and select your Docker Standalone Platform.
  3. Choose Web Editor as the source.
  4. Paste this Compose file. Use another host port if 8080 is already in use:
services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
  1. Select Docker Hub under Registry, fix any editor errors, and select Save.
  2. Select Deploy, enter hello-stack in the confirmation dialog, and select Deploy again. Wait for the operation to finish.
  3. Open the Services tab to check the running container.
  4. Open http://YOUR-DOCKER-HOST:8080 to see the Nginx welcome page.

For the local quick-start host, the website is http://localhost:8080. Its published port is reachable according to the Docker host's firewall rules.

Change or update the Stack

Example deployed Stack with running services and their logs

This example has a web service and a cache. Your first Stack will show only the web service from the Compose file above.

Edit the Compose file on the Config tab and save it, then select Deploy or Redeploy. Saving alone does not change the running application. The Releases tab shows successful releases and available rollback targets.

See Web Editor Stacks for storage and variables, or Git Stacks to keep Compose files in a repository. For Swarm, see Swarm Stacks: Citadel deploys native Swarm services and checks that the Compose fields are supported.

On this page