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
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
Global Options
| Option | Description |
|---|---|
--help, -h |
Show help for any command |
--version, -v |
Show StackMark version |