ssh

Configure SSH users, ports, bastion routing, and SSHKit concurrency for Kamal deployments.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/donnfelker/kamal-skills --skill ssh-donnfelker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ssh
Source: https://github.com/donnfelker/kamal-skills/tree/main/skills/ssh
Command: npx skills add https://github.com/donnfelker/kamal-skills --skill ssh-donnfelker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill resolves complex SSH connectivity issues, authentication failures, and performance bottlenecks when deploying applications with Kamal across single or multiple server environments.

Core Features & Use Cases

  • Connection Tuning: Configure custom SSH users, ports, and proxy/bastion host routing to match your infrastructure requirements.
  • Authentication Management: Securely handle SSH keys via secrets or local files and resolve common publickey permission errors.
  • Performance Optimization: Adjust SSHKit concurrency and DNS retry settings to prevent connection storms when deploying to large server fleets.

Quick Start

Use the ssh skill to configure the deployment to connect as the app user on port 2222 through a bastion host.

Frequently Asked Questions about ssh

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

FAQPage Schema
How do I configure Kamal SSH to deploy through a bastion host?

To configure Kamal SSH through a bastion host, you tune custom SSH users, ports, and proxy routing settings to match your infrastructure requirements and securely route deployment traffic.

Why does my Kamal deployment fail with SSH publickey permission errors?

Kamal deployment SSH publickey permission errors occur when authentication keys are not securely handled via local files or secrets, which this skill resolves by managing secure key authentication.

How do I prevent SSHKit connection storms when deploying to large server fleets?

To prevent SSHKit connection storms when deploying to large server fleets, you adjust SSHKit concurrency and DNS retry settings to optimize performance and manage connection concurrency tuning.

Can I connect as a non-root user on a custom port using Kamal SSH?

Yes, you can connect as a non-root user on a custom port using Kamal SSH by applying connection tuning configurations that specify custom SSH users and ports for your deployment environment.

What is the best way to debug SSH connection logs during a Kamal deployment?

The best way to debug SSH connection logs during a Kamal deployment is by utilizing SSH log debugging features to identify authentication failures and performance bottlenecks across your server environments.

Does Kamal SSH support routing through proxy hosts for secure key authentication?

Yes, Kamal SSH supports routing through proxy or bastion hosts while satisfying requirements for secure key authentication, allowing you to manage custom routing and secure keys via secrets or local files.