veyla enterprise deployment — Docker Desktop install

This guide describes the fastest path to running veyla enterprise on a single Windows or macOS workstation using Docker Desktop. It targets engineers running an evaluation install, a single-team deployment, or a developer test bench — anywhere a single host running Docker is acceptable.

For multi-node, high-availability, or air-gapped enterprise installs, use the OpenShift / Kubernetes guide instead. Both paths ship the same software; the difference is how it runs.

Audience

You should be comfortable with the Windows or macOS terminal (PowerShell or zsh), docker and docker compose, and editing a .env file. No Kubernetes or Helm knowledge required.

What you need

• Docker Desktop installed and running. Windows: the WSL2 backend is recommended. macOS: VirtioFS / Apple Virtualization is recommended.
• Deployment package — a .tar.gz (or .tgz) you received with your order. It contains the Docker image, a docker-compose.yml, an .env.example, and any deployment assets.
• Two configuration values — these come with the package:
  • PostgreSQL password (you choose this; write it down)
  • Rails SECRET_KEY_BASE (provided by software distributor)

What's in this section