StencilBox

AGPL-3.0
Platform
Linux Docker Self-hosted
Licence
AGPL-3.0 Open source
StencilBox

StencilBox is a free and open-source static site generator that turns YAML data files into small, fast, script-free websites. Instead of writing Markdown pages you describe your content as data — categories, links, statuses, whatever you need — and a build config pairs that data with a template to produce plain static output. It is built for self-hosters who want a homepage of links they can edit without touching Git, for sysadmins who want to give users a simple way to publish pages, and for developers who just want data rendered into a good-looking page.

Key features

  • YAML in, static HTML out — pages are generated once at build time, so the output loads almost instantly and ships no application runtime
  • Built-in templates: links-homepage for a categorised grid of links, iframe-sidebar for a persistent sidebar that keeps several web apps loaded for quick switching, and status-page for a status dashboard built from data
  • Several build configs per instance, so one container can serve a homepage for family, another for friends and another for you
  • Web admin UI for creating build configs, browsing templates, inspecting data files and running builds — every config is still a readable YAML file you can edit by hand
  • Favicon fetching at build time, with an optional url_internal per link for services that sit behind an authenticating reverse proxy
  • Build-time Git clones: point a config at an icon repository such as dashboard-icons and only the files the build actually uses end up in the output
  • No tracking, no telemetry, no ads, and no internet connection required at runtime
  • Small, single-binary Go service, distributed as a Docker image and as Linux amd64/arm64 tarballs; the project labels itself beta

Self-hosting

The published image runs as a single container with one volume for state: docker run -d --name StencilBox -v stencilbox-config:/config -p 4337:8080 ghcr.io/jamesread/stencilbox:latest. The service listens on port 8080 and the admin interface lives under /webui; a Docker Compose file with the same volume and port mapping is in the documentation. Configuration is a YAML file at /config/config.yaml, and STENCILBOX_OUTPUT_DIR, STENCILBOX_TEMPLATES_DIR and STENCILBOX_STATE_DIR relocate the built output, custom templates and build history. The first start creates a default admin account — change its password straight away, before the instance is reachable from anything but localhost.

Who it is for

Homelabbers who want a links homepage or a service catalogue generated from a file they can edit, sysadmins handing non-technical users a YAML-only publishing workflow, and developers who want data rendered to a page without installing a CMS. Markdown is not supported yet, so for blogs and long-form writing Hugo, Jekyll or Eleventy remain the better fit — StencilBox is about turning data into sites, not prose.

Licence

AGPL-3.0 — free software with every feature included: no “core”, “pro” or “enterprise” edition, no telemetry, and all code and assets available under the same licence.

Alternatives

  • Silex — visual static site builder if you would rather drag and drop than write YAML

Browse more free and open source tools in the directory, or submit a tool we have missed.

Explore More Categories

Sign In

Register

Reset Password

Please enter your username or email address, you will receive a link to create a new password via email.