vps-deploy

Automate VPS deployments with SSH, reverse proxy, SSL, and rollback.

20|4|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/algans/skillgen --skill vps-deploy-algans
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vps-deploy
Source: https://github.com/algans/skillgen/tree/main/skills/vps-deploy
Command: npx skills add https://github.com/algans/skillgen --skill vps-deploy-algans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deploying applications to VPS servers is error-prone and time-consuming, requiring manual SSH access, reverse proxy configuration, SSL setup, and careful rollback planning. This skill automates the entire deployment lifecycle, reducing downtime and human error.

Core Features & Use Cases

  • Auto-detects project runtime and deployment method (Docker-based or bare metal).
  • Configures reverse proxy (Nginx or Caddy) and SSL provisioning.
  • Creates backups to releases/ and supports rollback to previous versions.
  • Generates deploy.sh and update.sh scripts for one-click future deployments.
  • Includes step-by-step deployment workflow with health checks and automatic rollback on failure.

Quick Start

Configure your project in .deploy.yml and run the generated deploy.sh to perform the initial deployment.

Frequently Asked Questions about vps-deploy

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

FAQPage Schema
How do I automate application deployment to a VPS with Nginx and SSL?

Automating VPS deployment involves parsing a .deploy.yml configuration to orchestrate SSH connections, auto-detect runtimes, generate Nginx reverse proxy configs, provision SSL, and execute health checks with automated rollback on failure.

Can I use this deployment automation for both Docker and bare metal servers?

Yes, the deployment automation auto-detects the project runtime and supports both Docker-based and bare metal deployment methods, applying the appropriate reverse proxy and SSL setup for either environment.

What is the best way to configure a reverse proxy and SSL on a VPS?

Configuring a reverse proxy and SSL on a VPS is handled by generating Nginx or Caddy configurations during the deployment orchestration, automatically provisioning SSL certificates and validating setup through health checks.

How do I rollback a failed VPS deployment to a previous version?

Rolling back a failed VPS deployment is automated by creating backups to a releases/ directory prior to each deployment, triggering an automatic rollback if health checks fail after the update.

Do I need to manually SSH into my server every time I deploy an application?

No, manual SSH access is not required for every deployment. The process generates deploy.sh and update.sh scripts after the initial configuration, enabling one-click future deployments via automated SSH orchestration.

What are the limitations of using a .deploy.yml file for VPS deployment?

Using a .deploy.yml file for VPS deployment requires pre-configuring your project runtime and deployment parameters within the YAML structure, meaning any deployment logic outside the supported Nginx, Caddy, Docker, or bare metal paths is not automatically recognized.