Skip to main content

Docker Compose

Trying Vydon with Compose​

A compose.yml file is provided at the root of the repository. This uses our pre-built docker images so no building is required.

This file includes two other compose files that are found in the main repository.

  • Temporal Compose
  • Test Databases

We split out the Temporal compose file to make it easier to include in other places, as well as to keep the main compose clean and to have a separate of concerns.

This main compose.yml file is made to easily try Vydon and should not be used as-is for production deployments.

To bring it up:

docker compose up -d

Active development with hot reload uses a different entrypoint:

make dev          # build images locally and start the stack with hot reload
make dev/logs     # tail logs
make dev/down     # stop the stack (keeps volumes)
make dev/clean    # stop and wipe volumes (destructive)

Deploying Vydon with Compose​

If you wish to deploy Vydon to production with compose.yml, we don't currently offer a single compose.yml file to do this (yet.). However, you can easily combine main compose.yml and the temporal compose.yml files to achieve this.

The main compose.yml includes an api-seed and temporal-seed that may not be necessary and require extra files, so those can be omitted for minimal dependencies.

Once all of the containers come online, the app is now routable via http://localhost:3000.

Deploy with Docker Compose and Authentication​

Vydon ships a compose.auth.yml overlay that stands up Keycloak with a pre-configured realm so you can sign in with a standard username and password, completely offline.

docker compose -f compose.yml -f compose.auth.yml up -d

Keycloak comes default with two clients that allow the app and cli to login successfully.

On first boot up, Keycloak will assert itself with the provided Vydon realm.

When navigating to Vydon for the first time, you'll land on the Keycloak sign-in page. It is easy to create an account simply by going through the register flow. This will persist restarts due to the postgres volume mapping. If you wish to start over, simply delete the vydon docker volume to reset your database to a fresh state.