mini-app

Orchestrate mini-app deployment behind a Caddy and PM2 fleet router.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/TechNickAI/hermes-config --skill mini-app
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mini-app
Source: https://github.com/TechNickAI/hermes-config/tree/main/skills/mini-app
Command: npx skills add https://github.com/TechNickAI/hermes-config --skill mini-app

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides an operator guide to deploy and manage a fleet-local mini-app router stack (Caddy + PM2 + per-app authentication) using the openclaw-config framework, covering install, routing patterns, auth conventions, public exposure via Funnel, and troubleshooting pitfalls.

Core Features & Use Cases

  • Install and configure a centralized router on fleet machines.
  • Add, rename, password-protect, or remove mini-apps behind a single front door.
  • Diagnose routing, authentication, and exposure issues; safely recover from common failures.

Quick Start

Add a new mini-app by editing ecosystem.config.js, the Caddyfile, and per-app env vars, then reload PM2 and Caddy.

Frequently Asked Questions about mini-app

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

FAQPage Schema
How do I deploy multiple mini-apps behind a single Caddy router?

To deploy mini-apps behind a single Caddy router, configure an ecosystem.config.js for PM2 orchestration, update the Caddyfile with routing patterns, set per-app environment variables, and reload both services to apply changes.

What do I need to set up password protection for a mini-app fleet?

Password protection for a mini-app fleet requires setting the APP_PASSWORD environment variable for each specific application within your ecosystem.config.js before reloading the PM2 process manager and Caddy router.

How does PM2 orchestrate a fleet of mini-apps on a single machine?

PM2 orchestrates a fleet of mini-apps by managing the lifecycle of each application defined within an ecosystem.config.js file, allowing an operator to start, reload, and monitor all processes simultaneously behind a centralized Caddy router.

Can I expose a locally routed mini-app publicly using Tailscale Funnel?

Yes, you can expose a locally routed mini-app publicly by configuring Tailscale Funnel within your Caddyfile to route external traffic to the specific internal application endpoint managed by your PM2 fleet.

Why is my Caddy router returning authentication errors for a newly added mini-app?

Caddy router authentication errors for a newly added mini-app typically occur when the APP_PASSWORD or APP_TITLE environment variables are incorrectly configured in the ecosystem.config.js file before the PM2 process was reloaded.

What is the best way to remove an application from a mini-app fleet router?

The best way to remove an application from a mini-app fleet router is to delete its configuration block from both the ecosystem.config.js and Caddyfile, clear its environment variables, then reload PM2 and Caddy to update routing.