# Unraid Template Sync

Unraid Template Sync is a lightweight, standard-library-only Go service that receives authenticated GitHub push webhooks to automatically refresh private Community Applications (CA) XML templates on an Unraid server,. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3436/unraid-template-sync

## Description

Unraid Template Sync is a lightweight, standard-library-only Go service that receives authenticated GitHub push webhooks to automatically refresh private Community Applications (CA) XML templates on an Unraid server, keeping your self-hosted app definitions in sync with your private template repository.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

42/100 (Fair), based on 3 of 4 factors.
- Maintained: 69 (last commit 59 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/unraid-template-sync-1x3mq7h0pmemx5?q=Unraid-Template-Sync

## Common questions

### How should I configure the reverse proxy for the GitHub webhook?

Create an Nginx Proxy Manager Access List with the current GitHub hooks CIDR ranges and deny all other sources. Proxy the HTTPS hostname to the container port, which defaults to 9000, and do not add browser authentication.

### Do I need a GitHub personal access token for it to update templates?

No PAT is needed. It clones and fetches the configured public repository over HTTPS, while webhook delivery is validated with a shared WEBHOOK_SECRET and GitHub's X-Hub-Signature-256 header.

### What must be true about the mounted repository directory before first start?

If the REPO_DIR has no .git metadata, it must be empty; the service refuses to overwrite unrelated files. With GIT_CLEAN=true, untracked files in the managed checkout are deleted after it has been cloned.

### Does the container need credentials to pull the image?

The GHCR package must be public for an unauthenticated Unraid installation to pull it. After first publication, set the package visibility to public in GitHub's package settings.

### Can I check whether the last template sync succeeded?

Yes, GET /healthz reports the latest synchronization result. The webhook endpoint is POST /webhook for eligible GitHub deliveries.

---
Source: Our Local Host (https://ourlocalhost.com/app/3436/unraid-template-sync), the self-hosted and open-source app directory.
