proxmox-docker-host
CommunityOperate Proxmox CT100 Docker with confidence.
Software Engineering#docker#docker compose#ssh tunnel#proxmox#traefik#letsencrypt#infra troubleshooting
Authorwagnerra23
Version1.0.0
Installs0
System Documentation
What problem does it solve?
This Skill solves the operational confusion of deploying and troubleshooting Docker services on a Proxmox LXC host (CT 100) behind Traefik, where the source-of-truth must be git + docker compose rather than Portainer.
Core Features & Use Cases
- Subdomain + Let’s Encrypt TLS recipe: Creates the DNS A record and applies Traefik labels so the service is reachable at novo-servico.oimpresso.com with automatic certificates.
- Compose-managed deployment (source-of-truth): Uses versioned docker-compose.yml and runs docker compose up -d over SSH to keep Portainer as an observer for logs/exec/restart rather than the authority.
- Persistent Hostinger MySQL SSH tunnel (autossh sidecar): Adds an autossh-based tunnel container so the app can reach Hostinger MySQL reliably without exposing the DB publicly.
- Troubleshooting playbook: Diagnoses common issues like certificate issuance failures, Traefik 504 timeouts due to wrong Docker networks, and Portainer/UI divergence.
Quick Start
Deploy a new service with a subdomain by following the Skill recipe to add the DNS A record, create a docker-compose.yml with Traefik labels, and run docker compose up -d on the CT 100 via SSH.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: proxmox-docker-host Download link: https://github.com/wagnerra23/oimpresso.com/archive/main.zip#proxmox-docker-host Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.