servers

Define server roles and host configurations in Kamal deployments.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill eliminates the complexity of manually configuring server roles and host lists in Kamal, ensuring your deployment architecture is correctly defined and optimized for your specific workload requirements.

Core Features & Use Cases

  • Role-Based Architecture: Easily split your infrastructure into web, worker, and job-specific roles.
  • Host Tagging: Apply custom environment variables to specific servers using host tags.
  • Per-Role Tuning: Configure unique commands, memory limits, and proxy settings for individual roles to ensure efficient resource allocation.

Quick Start

Use the servers skill to configure a web role and a separate workers role with a custom command for background jobs.

Frequently Asked Questions about servers

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

FAQPage Schema
How do I configure Kamal deployment roles for separate web and worker servers?

To configure Kamal deployment roles, you define and structure server roles and host configurations to split your infrastructure into web, worker, and job-specific environments. This ensures your deployment architecture is correctly defined for specific workload requirements.

What is the best way to allocate custom container commands to specific servers in Kamal?

Allocating custom container commands in Kamal is handled through per-role tuning, allowing you to configure unique commands, memory limits, and proxy settings for individual roles to ensure efficient resource allocation across your infrastructure.

Can I apply custom environment variables to specific servers using host tags in Kamal?

Yes, you can apply custom environment variables to specific servers using host tags in Kamal. This host tagging feature allows targeted configuration across your defined server roles within the deployment ecosystem.

How do I designate a primary role for resource allocation in a Kamal deployment?

Designating a primary role in a Kamal deployment involves structuring your server roles to satisfy requirements for role-specific resource allocation and primary role designation as defined in the official Kamal documentation.

Does Kamal support splitting infrastructure into multi-role environments for background jobs?

Yes, Kamal supports splitting infrastructure into multi-role environments. You can configure a web role alongside a separate workers role with a custom command specifically for background jobs.