skills.rest
zot24
zot24COMMUNITY
Explore all skills by this author →
Website𝕏@zot24GitHub

umbrel-app

Convert Docker Compose services into validated Umbrel app packages.

2|Updated Jan 14, 2026
Search Tags:#debugging#docker#docker-compose#manifest-validation#app-submission#umbrel#app-packaging
One-click install
npx skills add https://github.com/zot24/skills --skill umbrel-app
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: umbrel-app
Source: https://github.com/zot24/skills/tree/main/skills/umbrel-app/skills/umbrel-app
Command: npx skills add https://github.com/zot24/skills --skill umbrel-app

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Building, converting, validating, testing, and submitting apps for umbrelOS involves many manual, error-prone steps: composing docker-compose files with correct APP_HOST/APP_PORT, pinning multi-arch image digests, mapping persistent volumes, and preparing submission-ready PRs. This Skill centralizes those tasks so developers can avoid common install failures, bad gateway issues, and insecure or non-deterministic packaging.

Core Features & Use Cases

  • Scaffold: Generate a compliant Umbrel app skeleton with docker-compose.yml, umbrel-app.yml, and exports.sh.
  • Validate & Lint: Check APP_HOST/APP_PORT formats, image @sha256 multi-arch digests, APP_DATA_DIR usage, restart policies, and manifest fields.
  • Convert & Test: Transform Docker Compose projects into Umbrel format, run local/device test flows, and provide debugging commands and remediation steps.
  • Submission & Sync: Produce PR-ready content for getumbrel/umbrel-apps, synchronize with upstream stores, and prepare required assets (icons, gallery).

Quick Start

Use the umbrel-app skill to scaffold a new Umbrel app, validate its compose and manifest, and generate a PR-ready package for submission.

Frequently Asked Questions about umbrel-app

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

FAQPage Schema
How do I convert a Docker Compose project into an Umbrel app?▼

Converting a Docker Compose project involves transforming services into the Umbrel app structure while enforcing APP_HOST/APP_PORT variables and APP_DATA_DIR for persistent volume mapping.

Why does my Umbrel app submission fail manifest validation?▼

Manifest validation fails when umbrel-app.yml fields are incorrect, Docker images lack pinned @sha256 multi-arch digests, or APP_HOST/APP_PORT formats and restart policies are non-compliant.

How do I fix bad gateway errors when testing Umbrel apps on umbrelOS?▼

Fix bad gateway errors on umbrelOS by validating that Docker Compose services correctly use APP_HOST and APP_PORT variables, then run provided debugging commands to identify and remediate service failures.

Do I need to pin Docker images to sha256 digests for Umbrel app packaging?▼

Yes, Umbrel app packaging requires pinning Docker images to @sha256 multi-arch digests to ensure secure, deterministic deployments and avoid submission failures.

What is the best way to prepare a PR-ready submission for the Umbrel app store?▼

The best way to prepare a PR-ready Umbrel app submission is to validate manifests, generate required gallery assets and icons, and synchronize your package with the getumbrel/umbrel-apps upstream repository.

Related Skills

Explore More Software Engineering Skills→
jpoutrinjpoutrin
14

portman

Manages per-worktree port allocations for git worktrees and docker-compose services.

Community
Advanced
zazzcodezazzcode
3

pr-builder

Draft reviewer-ready PR titles and bodies from branch diffs and test results.

Community
Intermediate
quan0715quan0715
31

qjudge-env-compose-owner

Run environment-specific Docker Compose commands inside QJudge containers.

Community
Intermediate
cwijayasundaracwijayasundara
3

deploy

Generate Docker Compose stacks, Dockerfiles, environment variables, and bootstrap scripts.

Community
Advanced