Skip to content

Quick Start

This page shows you how to quickly deploy your docker-compose file.

Deploy in 4 Easy steps

Deploy Step 1: Install celestical client

bash
pip install celestical

Skip if already installed.
We recommend you use a dedicated python environment. We use strong additional encryption so make sure you have OpenSSL >3. MacOS users might have various openssl versions coexisting (system, user with homebrew and python environment)

Deploy Step 2: User account creation

bash
celestical register

This creates your Celestical account and lets you authenticate for deploys.

Deploy Step 3: Login

bash
celestical login

If you are already logged in this is not necessary. You can also safely skip this, the next step will remind you to login if necessary.

Deploy Step 4: Run deploy

bash
celestical deploy my-compose-file.yml

You can omit to indicate the path to my-compose-file.yml, celestical deploy will try to find a local docker-compose.yml file (or compose.yml, standard supported names by docker compose).

More details

So far that's it. This simple approach should cover 80% of application use cases and architectures. For more complex use-cases have a look at our semantic orchestration.