up

Start the current worktree's Compose project.

Usage

docktree up [flags]

Starts the current worktree's Compose project. Docktree detects compose files, allocates unique ports, generates override files, and runs docker compose up -d.

Flags

FlagDescription
-f, --file <path>Use a specific Compose file instead of auto-detected ones
--buildForce rebuild of images with a build: directive
--create <branch>Create and prepare a new worktree before starting
--syncRun setup copy/symlink/run steps before starting
--validateCheck config, ports, and compose validity without starting
--dry-runShow what would happen without making changes

--validate and --dry-run are mutually exclusive.

Examples

Create a new worktree and start its stack:

docktree up --create feature/payment-gateway

Force rebuild and sync setup files:

docktree up --build --sync

Validate without starting:

docktree up --validate