/xCloud-Docker-Deploy-Skill

name: xcloud-docker-deploy
description: "xCloud Docker Deploy v1.4.1 — a confirmation-gated skill for preparing projects for xCloud. It inspects or changes files only after user consent, generates Docker/GHCR deployment files, fixes xCloud port rules, and routes live API work only after a separate explicit token-consent step."
license: Apache-2.0
version: "1.4.1"
author: "M Asif Rahman"
homepage: "https://github.com/Asif2BD/xCloud-Docker-Deploy-Skill"
source: "https://github.com/Asif2BD/xCloud-Docker-Deploy-Skill"
repository: "https://github.com/Asif2BD/xCloud-Docker-Deploy-Skill"
metadata:
  {
    "openclaw":
      {
        "emoji": "🐳",
        "requires": { "bins": ["git", "docker"] },
        "install":
          [
            {
              "id": "github",
              "kind": "link",
              "label": "GitHub",
              "url": "https://github.com/Asif2BD/xCloud-Docker-Deploy-Skill",
            },
            {
              "id": "release",
              "kind": "link",
              "label": "Latest Release",
              "url": "https://github.com/Asif2BD/xCloud-Docker-Deploy-Skill/releases/tag/v1.4.1",
            },
            {
              "id": "xcloud-agent-skills",
              "kind": "link",
              "label": "xCloud Agent Skills",
              "url": "https://app.xcloud.host/agent/skills",
            },
            {
              "id": "xcloud-api",
              "kind": "link",
              "label": "xCloud API Docs",
              "url": "https://app.xcloud.host/api/v1/docs",
            },
            {
              "id": "security",
              "kind": "link",
              "label": "Security Notes",
              "url": "https://github.com/Asif2BD/xCloud-Docker-Deploy-Skill/blob/main/SECURITY.md",
            },
          ],
      },
  }
tags:
  - docker
  - deployment
  - devops
  - xcloud
  - docker-compose
  - github-actions
  - wordpress
  - laravel
  - nextjs
  - nodejs
  - python
  - ci-cd
  - hosting
  - infrastructure
category: "DevOps & Deployment"
platforms:
  - claude-code
  - openClaw
  - claude-ai
  - cursor
  - windsurf
  - codex
  - any
security:
  verified: true
  package_no_runtime_network_calls: true
  no_executables: true
  templates_only: true
  requires_explicit_user_confirmation: true
  live_api_requires_separate_consent: true

xCloud Docker Deploy v1.4.1

[](https://github.com/Asif2BD/xCloud-Docker-Deploy-Skill/releases/tag/v1.4.1) [](https://clawhub.ai/asif2bd/skills/xcloud-docker-deploy) [](https://app.xcloud.host/agent/skills) [](LICENSE)

Built for xCloud Custom Docker deployments by [Asif2BD](https://github.com/Asif2BD) · [GitHub](https://github.com/Asif2BD/xCloud-Docker-Deploy-Skill) · [Latest Release](https://github.com/Asif2BD/xCloud-Docker-Deploy-Skill/releases/tag/v1.4.1) · [xCloud Agent Skills](https://app.xcloud.host/agent/skills)

Start Here

This is a deployment-preparation skill. Before it inspects a project, edits files, recommends production changes, asks for API tokens, or routes to live xCloud API skills, the agent must confirm the exact action with the user.

Use this safe opening:

> I can do read-only analysis first, or I can generate deployment files after your confirmation. I will not push, deploy, collect tokens, or call live xCloud APIs unless you explicitly approve that exact step.

Use normal human language. Ask:

> This is my project. I want to deploy it on xCloud. Please inspect it, decide whether it should use xCloud native deployment or Docker, generate the proper Dockerfile, Docker image workflow, docker-compose.yml, `.env.example`, and give me the exact xCloud deployment steps.

If you already have a compose file, ask:

> Please make this `docker-compose.yml` work on xCloud. Fix anything xCloud does not support, especially Docker build steps, proxy services, and host ports 80/443.

The agent should then: 1. Ask whether to perform read-only analysis or generate files. 2. Detect the stack after the user confirms project inspection. 3. Choose native xCloud deployment or Custom Docker. 4. Generate or fix Docker files only after explicit confirmation. 5. Explain the exact xCloud UI/API steps in simple language. 6. Before any production-impacting step, recommend a branch, backup, and staging/test deployment.

> **xCloud port-safety notice:** final compose output must never bind host port `80` or `443`. If an app listens on container port `80`, use `3080:80` and set xCloud's exposed/primary port to `3080`.

Adapt any `docker-compose.yml` to work with [xCloud](https://xcloud.host) — a git-push Docker deployment platform.

How xCloud Works

git push → xCloud runs: docker-compose pull && docker-compose up -d

**xCloud never runs `docker build`.** Images must be pre-built in a public registry. SSL, reverse proxy, and domain routing are handled by xCloud — your stack must not duplicate them.

Read `references/xcloud-constraints.md` for the full ruleset before making changes.

Current xCloud API + Agent Skills Context

xCloud now publishes API-backed agent skills for operational work:

| Official skill | Owns | |---|---| | `xcloud:servers` | Servers, PHP, databases, cron, firewall/fail2ban, sudo users, WordPress provisioning | | `xcloud:sites` | Site lifecycle, status, backups, domains, cache, SSH, site cron, git | | `xcloud:wordpress` | WordPress plugins, themes, updates, debug, magic login, vulnerabilities, PageSpeed | | `xcloud:ssl` | SSL certificates: view, install, renew, status, delete | | `xcloud:account` | Current user, API tokens, Cloudflare integrations, blueprints, health |

Use this skill for project detection, Dockerfile/compose generation, GHCR CI, and xCloud Custom Dock