Commands Reference

Complete reference for all StackMark CLI commands.

Stack Management

stackmark add [name]

Register a Docker Compose project with StackMark.

Option Description
--path, -p Path to docker-compose.yml (default: current directory)
--domain, -d Local domain for /etc/hosts (e.g., myapp.local)
Example
$ cd ~/Dev/myapp
$ stackmark add
✔ Stack "myapp" registered

stackmark remove <name>

Unregister a stack from StackMark (does not delete files).

Example
$ stackmark remove myapp
✔ Stack "myapp" removed

stackmark list

List all registered stacks with their status and ports.

Example
$ stackmark list
NAME STATUS PORTS
myapp running 9003, 9004
api-project stopped 9010, 9011

Stack Operations

stackmark start [name]

Start a stack with automatic port management.

Option Description
--no-override Use original ports from docker-compose.yml (skip port remapping)
Example
$ stackmark start myapp
✔ Starting myapp...
✔ Stack is running
→ http://localhost:9003

stackmark stop [name]

Stop a running stack.

Example
$ stackmark stop myapp
✔ Stack "myapp" stopped

stackmark restart [name]

Restart a stack (stop + start).

Option Description
--no-override Use original ports from docker-compose.yml (skip port remapping)
Example
$ stackmark restart # Uses auto-detection
✔ Restarting myapp...

stackmark status [name]

Show detailed status of a stack and its containers.

Option Description
-a, --all Show all stacks (ignore auto-detection)
Example
$ stackmark status myapp
Stack: myapp
Status: running
Path: /home/user/Dev/myapp
CONTAINER STATUS PORT
nginx Up 2m localhost:9003 → 80
mysql Up 2m localhost:9004 → 3306
redis Up 2m (no ports exposed)

Logs & Monitoring

stackmark logs [name]

View logs from stack containers.

Option Description
-f, --follow Follow log output in real-time
Example
$ stackmark logs -f myapp

stackmark dash

Open interactive TUI dashboard with real-time updates.

stackmark dash
🐳 StackMark Dashboard
──────────────────────────────────────
● myapp running
→ http://localhost:9003
Other: db:9004, redis:9005
○ api-project stopped
Press q to quit • Auto-refresh: 2s

stackmark web

Launch a local web dashboard in your browser with real-time updates.

Option Description
-p, --port <port> Port to run the server on (default: 3456)
-o, --open Open browser automatically
Example
$ stackmark web --open
🐳 Stackmark Dashboard
● Server running at http://localhost:3456
Press Ctrl+C to stop
Features: The web dashboard displays all stacks with their status, forwarded ports, container details, and clickable URLs. It auto-refreshes every 3 seconds.

Quick Access

stackmark open [name]

Open stack's main URL in your default browser.

Example
$ stackmark open myapp
✔ Opening http://localhost:9003

Project Templates

stackmark init

Generate a docker-compose.yml with interactive prompts.

Example
$ stackmark init
✔ Generated docker-compose.yml

See Templates for available templates and services.

Hosts Management

stackmark hosts sync

Sync hosts with running stacks (requires sudo).

Example
$ sudo stackmark hosts sync
✔ Added: 127.0.0.1 myapp.local
✔ Added: 127.0.0.1 api.local

Autostart Management

Control whether containers automatically start on system boot.

stackmark autostart disable [name]

Disable automatic container startup on system boot. This prevents your development containers from consuming resources when you restart your computer.

Example
$ stackmark autostart disable myapp
✔ Autostart disabled for "myapp"
Containers will NOT restart automatically on system boot

stackmark autostart enable [name]

Enable automatic container startup on system boot. Containers will restart automatically when your system boots.

Example
$ stackmark autostart enable myapp
✔ Autostart enabled for "myapp"
Containers will restart automatically on system boot
Note: The autostart status is displayed in stackmark list and stackmark status commands. New stacks created with stackmark init have autostart disabled by default.

Global Options

Option Description
--help, -h Show help for any command
--version, -v Show StackMark version