Skip to main content

​
Container Runtime

The oxy start command manages PostgreSQL and other services in Docker containers. You need a Docker-compatible container runtime installed before using it.

​
Quick Install

Download and install from docker.com/products/docker-desktop for macOS, Windows, or Linux.

​
Verify

Run the following to confirm Docker is working: 
docker ps
If this prints an empty table (or a list of running containers), you’re ready to use oxy start.
For alternative runtimes (Podman, OrbStack), custom socket locations, troubleshooting, and advanced configuration, see the full Container Runtime Support guide.

​
Windows (WSL)

On Windows, Oxy runs inside WSL 2. WSL 1 will not work — Docker socket integration requires WSL 2.
1

Ensure WSL 2

Check your WSL version from PowerShell:
wsl -l -v
If your distro shows VERSION 1, upgrade it:
wsl --set-version <DistroName> 2
wsl --shutdown
2

Enable WSL integration in your container runtime

If using Rancher Desktop: go to Preferences → WSL → Integrations, enable the toggle for your WSL distro (e.g., Ubuntu), and click Apply.If using Docker Desktop: go to Settings → Resources → WSL Integration and enable your distro.
If the Integrations tab is empty (no distros listed), fully quit the application, run wsl --shutdown from PowerShell, then reopen it. If it’s still empty, uninstall and reinstall.
3

Verify inside WSL

Open your WSL terminal and run:
docker ps