A standardized, reliable workflow for deploying and updating applications on a single machine using Docker Compose.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install docker-compose-deploy
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install docker-compose-deploy using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Docker Compose Single-Machine Deployment?
This skill provides a structured, production-ready blueprint for deploying applications on a single server using Docker Compose. By establishing strict directory conventions, environment variable configurations, and pre-deployment port verification, it ensures reliable and repeatable operations.
Designed for developers and system administrators, this workflow also integrates critical verification commands, rollback safety measures (such as database and SQLite backups), and network configuration best practices. Leveraging this template within Openclaw Skills ensures your self-hosted deployments remain robust, secure, and easy to maintain.
Docker Compose Single-Machine Deployment Use Cases
- Standardizing single-server web application deployments using Docker Compose.
- Setting up local or staging environments with precise volume mapping and configuration isolation.
- Executing zero-downtime-minded application upgrades with rapid rollback capabilities.
- Managing environment-specific configurations securely without exposing secrets to version control.
How Docker Compose Single-Machine Deployment Works
- Pre-flight Checks: Verify that targeted external ports are free and check cloud firewall settings.
- Directory Isolation: Create a dedicated directory structure under
/opt/app-name/to keep configs, data, and logs separate. - Payload Delivery: Upload the application package, source code, or Docker assets to the target server.
- Environment Configuration: Set up local environment variables within a
.envfile without committing actual secrets. - Execution & Build: Run
docker compose up -d --buildto build images and launch containers in detached mode. - Verification & Health Check: Query container health endpoints and inspect startup logs to ensure a successful launch.
Docker Compose Single-Machine Deployment Setup
To use this deployment workflow, ensure you have Docker and Docker Compose installed on your target machine. Organize your directory structures on the server as follows:
# Create deployment directory structure
mkdir -p /opt/app-name/{data,config,logs}
# Navigate to deployment directory
cd /opt/app-name/
Create a basic docker-compose.yml file and a .env file containing your production settings. To deploy or update your application, execute:
docker compose up -d --build
Docker Compose Single-Machine Deployment Data Schema & Taxonomy
This workflow prescribes a strict and clean directory taxonomy to isolate stateful data from code. Below is the directory organization schema:
| Path | Purpose | Notes |
|---|---|---|
/opt/app-name/ |
Root Deployment Directory | Standard deployment base |
/opt/app-name/docker-compose.yml |
Compose Specification | Defines services, networks, and volumes |
/opt/app-name/.env |
Environment Variables | Contains app configurations (exclude secrets from git) |
/opt/app-name/data/ |
Stateful Application Data | Must be mounted as host volume |
/opt/app-name/config/ |
Application Configuration Files | Static files loaded by containers |
/opt/app-name/logs/ |
Runtime Application Logs | Mounted for persistence and centralized log collection |
Docker Compose Single-Machine Deployment Advanced Features
- Rollback Mitigation: Ready-to-use strategy of keeping the previous container image tag and performing SQLite backups before any database migrations.
- Firewall Alignment: Explicit guidance on checking system firewalls and cloud network security groups when opening 5-digit external ports.
- Minimal Dependency Model: Prevents bloated deployments by explicitly recommending against bundling Redis or MySQL databases unless strictly required by the core application.
- Robust Verification: Pre-defined health-check validation commands like
curl -fsS http://127.0.0.1:18088/healthzintegrated directly into Openclaw Skills deployment practices.
SKILL.md
Loading
Related Openclaw Skills
Website Analytics (fleets)
A read-only command-line and MCP interface for Google Analytics (GA4) designed for developers and AI agents.
Code Complexity Analyzer
An automated AI agent skill designed to analyze cyclomatic complexity, detect code smells, and provide intelligent refactoring suggestions.
ZK-Bankir Monitor
A secure, read-only monitoring skill designed to track ZK-Bankir sovereign banking treasuries, verify SHA-256 hash-chains, and audit multi-asset balances.
BTC Sovereign Tracker
A secure, watch-only Bitcoin self-custody tracker designed to monitor COLDCARD Q vault health, mempool fees, UTXOs, and on-chain metrics.
CI/CD Config Helper
An automated configuration assistant that generates optimized CI/CD pipelines for GitHub Actions, GitLab CI, and Jenkins platforms.
Reply Session Conflict Fix
A comprehensive 3-layer diagnostic and permanent self-healing fix for the 'reply session initialization conflicted' error in OpenClaw gateway environments.
Featured*
