# Puppetboard

Puppetboard is a visual dashboard for monitoring your puppet infrastructure. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/6568/puppetboard

## Description

Puppetboard is a visual dashboard for monitoring your puppet infrastructure. It transforms complex data into clear charts and lists, allowing you to see which servers are running correctly, identify errors quickly, and track changes across your entire network through a simple web interface.

## Platform availability

Available on 0 of 10 platforms.

## Health score

60/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 1 day ago)
- Popular: 57 (735 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Security check: 20 (1 serious finding, 1 minor, CI, tests, OpenSSF Scorecard 7.1/10)

## Security check

1 serious finding: Uses certifi 2026.7.22, which has a known critical vulnerability.
Automated checks on commit cfb8075, 29 Oct 2026. Not an audit.

## Links

- Docker Hub: https://hub.docker.com/r/voxpupuli/puppetboard
- GitHub: https://github.com/voxpupuli/puppetboard

## Common questions

### Why is Puppetboard unreachable in Docker after I stop using --net=host?

If you remove --net=host, you need to publish a port so the browser can reach the container. Without a published port, the app may start but remain unreachable.

### What Docker environment settings are required to point Puppetboard at PuppetDB?

Set PUPPETDB_HOST and PUPPETDB_PORT to your PuppetDB server and replace SECRET_KEY with a long random string. Without a strong secret, the web session is not properly protected.

### How should Puppetboard be configured for an HTTPS PuppetDB?

Mount a folder containing PuppetDB's key.pem and cert.pem into the container and set PUPPETDB_KEY and PUPPETDB_CERT. Missing or unreadable certificates can stop Puppetboard from connecting securely.

### How can I serve Puppetboard through Apache?

The Puppet module includes puppetboard::apache::vhost, which uses the official Puppet Labs Apache module's apache::vhost defined type to create a full virtual host.

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