vps-deploy

Automate GitHub-to-VPS deployment with SSH keys, workflows, and health checks.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Avi977/ace-claude-toolkit --skill vps-deploy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vps-deploy
Source: https://github.com/Avi977/ace-claude-toolkit/tree/main/skills/vps-deploy
Command: npx skills add https://github.com/Avi977/ace-claude-toolkit --skill vps-deploy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the reliable deployment of applications to a VPS whenever a non-main branch is pushed, handling SSH setup, deploy keys, GitHub Secrets, workflow creation, and post-deploy health checks.

Core Features & Use Cases

  • Automated SSH key management and deploy-key rotation.
  • GitHub Actions workflow generation to deploy from a branch to VPS.
  • Health checks and auto-rollback on deployment failure.
  • Manual deployment fallback via SSH.

Quick Start

Configure the deployment by running the vps-deploy skill to set up SSH keys, GitHub Secrets, and a GitHub Actions workflow for automated VPS 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 VPS deployment via GitHub Actions when pushing to a non-main branch?

Automate VPS deployment by generating a GitHub Actions CI workflow that connects via SSH credentials and deploy keys to push your branch to the remote server, followed by post-deploy health checks to ensure stability.

What is the best way to set up SSH credentials and GitHub Secrets for automated VPS deployment?

Set up SSH credentials for VPS deployment by generating deploy keys and storing them as GitHub Secrets, allowing the CI workflow to securely authenticate with the remote Linux server during automated branch deployments.

Does automated VPS deployment support health checks and rollback on failure?

Automated VPS deployment supports health checks and auto-rollback mechanisms that trigger if the deployment fails, ensuring your server remains stable and reverts problematic non-main branch updates.

Can I manually deploy to a VPS via SSH if the GitHub Actions workflow fails?

You can manually deploy to your VPS via SSH as a fallback mechanism if the automated GitHub Actions workflow or post-deploy health checks fail during the branch deployment process.

Do I need a specific project structure to configure GitHub Actions for VPS deployment?

Configuring GitHub Actions for VPS deployment requires a target project structure on the remote server, along with SSH access and deploy keys, to properly execute the workflow and health checks.