skills.rest
danysgit
danysgitCOMMUNITY
Explore all skills by this author →
GitHub

unraid-app-builder

Package self-hosted Docker apps for Unraid with canonical manual user-templates and container metadata.

2|Updated Apr 13, 2026
Search Tags:#template#packaging#docker#webui#unraid#appdata
One-click install
npx skills add https://github.com/danysgit/unraid-app-builder-skill --skill unraid-app-builder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unraid-app-builder
Source: https://github.com/danysgit/unraid-app-builder-skill/tree/main
Command: npx skills add https://github.com/danysgit/unraid-app-builder-skill --skill unraid-app-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps you package self-hosted Docker apps for Unraid without the usual template mismatches, missing WebUI links, or broken host port and appdata mappings.

Core Features & Use Cases

  • Unraid packaging workflow: Shapes an app into a first-pass-ready Unraid deployment with a canonical manual user-template.
  • Template and metadata authoring: Produces the fields Unraid expects, including WebUI, icon, support, project, registry, and template links.
  • Persistence and validation: Checks that /config, editable ports, and user changes survive install and update flows on a real Unraid host.
  • Use Case: You have a Dockerized self-hosted app and want Codex to add proper Unraid support, fix container integration issues, and validate the final install behavior.

Quick Start

Use the unraid-app-builder skill to package this Docker app for Unraid with a canonical my-template, correct metadata, and a validation checklist.

Frequently Asked Questions about unraid-app-builder

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

FAQPage Schema
How do I package a self-hosted Docker app for Unraid?▼

To package a Docker app for Unraid, you generate a canonical manual user-template (my-...xml) with correct container metadata, including WebUI, icon, support, and project links. This ensures the app installs cleanly and passes validation checks.

What metadata is required for an Unraid dockerMan-compatible template?▼

An Unraid dockerMan-compatible template requires specific fields including WebUI, icon, support, project, registry, and template links. It also requires exposing editable host ports and appdata paths for user customization during installation.

Why does my Unraid container lose settings after an update?▼

Unraid containers lose settings after updates if /config persistence is not properly configured. Validating that /config, PUID/PGID/UMASK settings, and user changes survive install and update flows on a live Unraid host prevents this data loss.

Does my Docker app need PUID and PGID support to run on Unraid?▼

Yes, Docker apps running on Unraid need PUID/PGID/UMASK support to handle file permissions correctly. Including these variables in your Unraid packaging ensures the container interacts properly with the host's appdata shares.

What is the best way to fix broken WebUI links in Unraid app templates?▼

The best way to fix broken WebUI links in Unraid app templates is to author correct dockerMan-compatible template fields during the packaging process. This aligns the container metadata with Unraid's expected WebUI, support, and project URLs.

Related Skills

Explore More Software Engineering Skills→
KuaaMUKuaaMU
4

docker-patterns

Configure Docker and Docker Compose for multi-service containerized applications.

Community
Intermediate
SongYunSeopSongYunSeop
1

setup-obsidian

Install or update the Oh My TIL Obsidian plugin in the current vault.

Community
Basic
thesammykinsthesammykins

unraid-guru

Automate Unraid administration with Docker template XML, storage tuning, and VM optimization.

Community
Advanced
prata0xprata0x

integration-test

Automate end-to-end integration tests across Docker and SaaS hosting services.

Community
Advanced