portainer-deploy

Generate GitHub Actions workflows, Docker Compose files, and Portainer webhooks for Docker deployments.

Updated Dec 24, 2025
One-click install
npx skills add https://github.com/korjavin/claude-common-skills --skill portainer-deploy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: portainer-deploy
Source: https://github.com/korjavin/claude-common-skills/tree/main/skills/portainer-deploy
Command: npx skills add https://github.com/korjavin/claude-common-skills --skill portainer-deploy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides users through setting up automated deployment pipelines for Docker projects by generating GitHub Actions workflows, Docker Compose files, and Portainer webhooks.

Core Features & Use Cases

  • Auto-generates a GitHub Actions workflow to build and push Docker images to ghcr.io and update docker-compose.yml with SHA tags.
  • Creates or updates Docker Compose configurations and triggers Portainer redeploy webhooks for seamless stack updates.
  • Supports Traefik reverse proxy configurations for secure, automated HTTPS in multi-service deployments.

Quick Start

Use the portainer-deploy skill to configure deployment for a new project by saying: "Set up Portainer deployment with CI/CD" and follow the guided prompts.

Frequently Asked Questions about portainer-deploy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Docker deployment to Portainer using GitHub Actions?

To automate Docker deployment to Portainer using GitHub Actions, you need a workflow that builds and pushes images to ghcr.io, updates docker-compose.yml with SHA tags, and triggers a Portainer redeploy webhook. This skill generates those configurations automatically.

What is a Portainer webhook and how does it work for stack redeployment?

A Portainer webhook is an HTTP endpoint that triggers an automated stack redeploy on a Portainer instance. When called by a CI/CD pipeline after a new image is pushed, it pulls the latest image and restarts the Docker Compose stack.

Can I use Traefik reverse proxy with Docker Compose for automated HTTPS in Portainer?

Yes, you can use Traefik reverse proxy with Docker Compose for automated HTTPS in Portainer. This skill supports generating Traefik configurations to route traffic securely across single or multi-service deployments.

Do I need a Dockerfile in my GitHub repository to set up Portainer CI/CD deployment?

Yes, a Dockerfile in your GitHub repository is a strict requirement to set up Portainer CI/CD deployment. The automation process relies on building the Docker image from this file before pushing it to ghcr.io.

What is the best way to update docker-compose.yml image tags during a CI/CD pipeline?

The best way to update docker-compose.yml image tags during a CI/CD pipeline is to automatedly replace them with the specific GitHub SHA build tags. This ensures the Portainer stack pulls the exact image version built during the workflow run.

Does this Portainer deployment automation support multi-service Docker projects?

Yes, this Portainer deployment automation supports multi-service Docker projects. It generates Docker Compose configurations and optional Traefik reverse proxy rules to manage multiple container services within a single stack.