secrets

Manage sensitive environment variables and credentials for Kamal deployments.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the challenge of managing sensitive deployment credentials by providing a secure, standardized way to reference secrets from password managers or environment variables without ever committing plaintext values to version control.

Core Features & Use Cases

  • Vault Integration: Provides helpers to fetch secrets from 1Password, Bitwarden, AWS Secrets Manager, and other providers using a unified command interface.
  • Environment Mapping: Simplifies the process of wiring secrets into config/deploy.yml using clear/secret blocks and aliasing.
  • Use Case: When you need to rotate your database password or registry credentials, use this skill to pull the latest values directly from your vault into your deployment process during execution.

Quick Start

Use the secrets skill to fetch my registry password from 1Password and configure it for my current Kamal deployment.

Frequently Asked Questions about secrets

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

FAQPage Schema
How do I manage Kamal deployment secrets without storing plaintext credentials in version control?

Inject Kamal deployment secrets by integrating with external password managers like 1Password, Bitwarden, or AWS Secrets Manager. This prevents plaintext credentials from entering version control by fetching values dynamically during execution and substituting them into config/deploy.yml.

Can I pull environment variables from 1Password or Bitwarden directly into Kamal?

Yes, you can pull secrets from 1Password or Bitwarden directly into Kamal. The skill provides a unified command interface to fetch credentials from these vaults and wire them into config/deploy.yml using dotenv-based workflows.

What is the best way to scope database passwords for different environments in Kamal?

Use multi-environment secret scoping to manage database passwords across different Kamal deployment targets. This feature maps specific credentials from your vault to distinct environments, ensuring each target uses the correct rotated secrets during execution.

Does this approach support fetching credentials from AWS Secrets Manager for Kamal deployments?

Yes, this approach supports fetching credentials from AWS Secrets Manager for Kamal deployments. It integrates with AWS Secrets Manager alongside other providers like 1Password and Bitwarden to automate secret extraction and injection into your deployment configuration.

How do I rotate registry credentials in Kamal without updating config files manually?

Rotate registry credentials without manual config file updates by referencing the latest values directly from your password manager. The skill fetches updated secrets during the Kamal deployment process and automatically injects them into config/deploy.yml through command substitution.