# Podium

Podium is a lightweight Docker container that clones, builds, and serves static sites or web apps from GitHub repositories, each on its own port. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7542/podium

## Description

Podium is a lightweight Docker container that clones, builds, and serves static sites or web apps from GitHub repositories, each on its own port. It polls the branches it tracks and rebuilds automatically on every push, keeping the previous version live if a build fails - so homelab users can run and keep multiple sites continuously updated from a single container without image rebuilds, manual deploys, or a CI pipeline.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

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

## Links

- Unraid: https://ca.unraid.net/apps/app_66c93dd28230163b
- GitHub: https://github.com/ggardenhire/podium

## Common questions

### How do I configure Podium to run several GitHub repositories in one container?

Set SITES to a JSON array containing one object per site. Each object needs a repo and a unique port, and can also set branch, build, and output.

### What should I configure for a plain static repository with no build step?

Set build to an empty string and output to . so the repository root is published directly.

### How can I deploy from a private GitHub repository?

Put a username and token in the repository URL used for cloning. Use a fine-grained personal access token with read-only Contents scope.

### What happens if a new build fails after I push?

The failed build is logged and the previous version stays live. The failure does not affect the other sites in the container.

### How often does Podium check for new pushes?

It checks at the interval set by POLL_INTERVAL, which defaults to 300 seconds.

### Will an existing single-repo setup keep working?

If SITES is unset, Podium builds one site from the old REPO_URL, REPO_BRANCH, PORT, BUILD_CMD, and OUTPUT_DIR variables.

---
Source: Our Local Host (https://ourlocalhost.com/app/7542/podium), the self-hosted and open-source app directory.
