StaticPages

Appearance

StaticPagesStatic hosting made simple, secure, and scalable.

StaticPages is a simple server implementation to host your static pages with support for preview URLs.

Get Started →GitHub Releases →

Why StaticPages?

A powerful and flexible static hosting backend for your sites, with seamless GitHub CI/CD support.

GitHub OIDC Authentication

Secure, fine-grained access via GitHub Actions with native OIDC token verification.

Fast Parallel Uploads

Deploy your site in seconds with parallelized file uploads and real-time feedback.

Production & Preview Builds

Easily publish to your domain, with optional preview builds on per-branch or per-commit basis.

Custom Domains & Wildcard Subdomains

Serve sites from your own domains with support for wildcard TLS and subdomain routing.

S3-Compatible Storage

Use any S3 backend, including Backblaze B2, AWS S3, or MinIO for artifact storage.

Helm Deployment

Ready-to-run Helm chart makes deploying on Kubernetes effortless and secure.

OpenTelemetry Instrumentation

Full support for OpenTelemetry tracing for visibility into uploads and page requests.

Minimal Footprint

Lightweight Go binary runs anywhere — from Raspberry Pi to production Kubernetes clusters.

Releases

Select your platform

v0.2.2

Release notes

Bug Fixes

  • deps: replace the deprecated otelaws and bring the docs site current (#439) (8856fa5)
  • deps: update aws-sdk-go-v2 monorepo (#298) (9447043)
  • deps: update aws-sdk-go-v2 monorepo (#311) (93c6950)
  • deps: update aws-sdk-go-v2 monorepo (#316) (dcb5e28)
  • deps: update aws-sdk-go-v2 monorepo to v1.104.0 (#301) (8492bda)
  • deps: update go modules (#327) (c5d3a0f)
  • deps: update go modules (#331) (a807de6)
  • deps: update go modules (#335) (aab5465)
  • deps: update go modules (#343) (efc7b77)
  • deps: update go modules (#345) (bbc2f2f)
  • deps: update go modules (#346) (29193bb)
  • deps: update go modules (#351) (9b4d52c)
  • deps: update go modules (#354) (6eea623)
  • deps: update go modules (#358) (eff36d6)
  • deps: update go modules (#364) (e16a1b5)
  • deps: update go modules (#375) (0639069)
  • deps: update go modules (#382) (e6e25dc)
  • deps: update go modules (#384) (4686eaf)
  • deps: update go modules (#388) (b46c880)
  • deps: update go modules (#395) (bafde41)
  • deps: update go modules (#403) (5932feb)
  • deps: update go modules (#410) (f59183f)
  • deps: update go modules (#423) (dcc0051)
  • deps: update go modules (#427) (5ce3629)
  • deps: update go modules (#433) (28aaff5)
  • deps: update go modules to v0.70.0 (#353) (ba9f2eb)
  • deps: update module github.com/aws/aws-sdk-go-v2/credentials to v1.19.28 (#321) (afa5078)
  • deps: update module github.com/aws/aws-sdk-go-v2/credentials to v1.19.33 (#347) (b7d25bb)
  • deps: update module github.com/aws/aws-sdk-go-v2/credentials to v1.20.1 (#391) (2694d35)
  • deps: update module github.com/aws/aws-sdk-go-v2/credentials to v1.20.5 (#416) (549a7af)
  • deps: update module github.com/aws/aws-sdk-go-v2/service/s3 to v1.107.0 (#355) (4201fdb)
  • deps: update module github.com/aws/aws-sdk-go-v2/service/s3 to v1.113.1 (#413) (2692034)
  • deps: update module github.com/aws/aws-sdk-go-v2/service/s3 to v1.114.0 (#431) (b569298)
  • deps: update module github.com/aws/smithy-go to v1.27.3 (#309) (8da627d)
  • deps: update module github.com/aws/smithy-go to v1.27.7 (#356) (73f6901)
  • deps: update module github.com/aws/smithy-go to v1.28.2 (#419) (4f00585)
  • deps: update module github.com/coreos/go-oidc/v3 to v3.19.0 (#304) (14e704f)
  • deps: update module github.com/coreos/go-oidc/v3 to v3.20.0 (#322) (b1d3889)
  • deps: update module github.com/gin-contrib/zap to v1.1.8 (#406) (3f11801)
  • deps: update module github.com/jellydator/ttlcache/v3 to v3.4.1 (#307) (5d089fa)
  • deps: update module github.com/stretchr/testify to v1.12.0 (#367) (ad9bb68)
  • deps: update module github.com/stretchr/testify to v1.12.1 (#368) (ef83e4a)
  • deps: update opentelemetry-go-contrib monorepo to v0.69.0 (#299) (3611b48)
  • get main's release and docs workflows green again (#436) (24da48f)
  • harden the upload API and the proxy (#437) (3d6582f)

v0.2.1

Release notes

Features

  • observability: richer span attributes, AWS SDK tracing, single log format (70e6a25)

v0.2.0

Release notes

⚠ BREAKING CHANGES

  • proxy: the configured not-found page is now served with HTTP 404 instead of 200, and searchPath entries beginning with "." are treated as filename suffixes (clean URLs) rather than sub-paths.

Features

  • proxy: reliability fixes, clean-URL resolution, and pageDefaults config (3eb6b53)

Bug Fixes

  • deps: update aws-sdk-go-v2 monorepo (#132) (ad17a4d)
  • deps: update aws-sdk-go-v2 monorepo (#142) (f36da86)
  • deps: update aws-sdk-go-v2 monorepo (#150) (5c5df36)
  • deps: update aws-sdk-go-v2 monorepo (#163) (d670914)
  • deps: update aws-sdk-go-v2 monorepo (#197) (4a5c8d2)
  • deps: update aws-sdk-go-v2 monorepo (#214) (537ec85)
  • deps: update aws-sdk-go-v2 monorepo (#222) (d35aa00)
  • deps: update aws-sdk-go-v2 monorepo (#231) (aa344d9)
  • deps: update aws-sdk-go-v2 monorepo (#249) (951da81)
  • deps: update aws-sdk-go-v2 monorepo (#272) (119163e)
  • deps: update aws-sdk-go-v2 monorepo (#278) (a723b2e)
  • deps: update aws-sdk-go-v2 monorepo (#283) (6e1b24b)
  • deps: update github.com/johannesboyne/gofakes3 digest to 4c385a1 (#178) (688767a)
  • deps: update module github.com/aws/aws-sdk-go-v2/credentials to v1.19.9 (#190) (e5f8b4e)
  • deps: update module github.com/aws/aws-sdk-go-v2/service/s3 to v1.100.0 (#245) (1855ec8)
  • deps: update module github.com/aws/aws-sdk-go-v2/service/s3 to v1.95.0 (#157) (2d0217a)
  • deps: update module github.com/aws/aws-sdk-go-v2/service/s3 to v1.96.0 (#172) (16f3083)
  • deps: update module github.com/aws/aws-sdk-go-v2/service/s3 to v1.96.2 (#203) (bf092c9)
  • deps: update module github.com/aws/aws-sdk-go-v2/service/s3 to v1.97.3 [security] (#227) (a85152c)
  • deps: update module github.com/aws/smithy-go to v1.24.0 (#128) (5c3e21f)
  • deps: update module github.com/aws/smithy-go to v1.24.1 (#194) (9baa32e)
  • deps: update module github.com/aws/smithy-go to v1.24.2 (#204) (9c03185)
  • deps: update module github.com/aws/smithy-go to v1.25.1 (#239) (1d3dcf2)
  • deps: update module github.com/aws/smithy-go to v1.27.2 (#284) (aac1434)
  • deps: update module github.com/coreos/go-oidc/v3 to v3.18.0 (#246) (88b29ef)
  • deps: update module github.com/fsnotify/fsnotify to v1.10.0 (#250) (fb3a021)
  • deps: update module github.com/fsnotify/fsnotify to v1.10.1 (#267) (470dfd0)
  • deps: update module github.com/gin-contrib/zap to v1.1.7 (#234) (a267e43)
  • deps: update module github.com/gin-gonic/gin to v1.12.0 (#205) (9aa7a31)
  • deps: update module github.com/spf13/cobra to v1.10.2 (#133) (ccd0ee0)
  • deps: update module github.com/zsais/go-gin-prometheus to v1.0.3 (#183) (0b5a576)
  • deps: update module go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin to v0.64.0 (#139) (b60adbe)
  • deps: update module go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin to v0.65.0 (#175) (53aea85)
  • deps: update module go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin to v0.66.0 (#208) (b6ed096)
  • deps: update module go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin to v0.67.0 (#217) (09b79e0)
  • deps: update module go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin to v0.68.0 (#252) (ea5858c)
  • deps: update module go.uber.org/zap to v1.28.0 (#256) (4bdbfd4)
  • deps: update opentelemetry-go monorepo to v1.42.0 (#209) (56b6cb6)
  • deps: update opentelemetry-go monorepo to v1.42.0 (#209) (41ed272)

v0.1.5

Release notes

Features

  • docs: improve documentation (c28693d)

Bug Fixes

  • deps: update aws-sdk-go-v2 monorepo (#107) (10b7812)
  • deps: update aws-sdk-go-v2 monorepo (#116) (d522d7e)
  • deps: update aws-sdk-go-v2 monorepo (#121) (e8eff7c)
  • deps: update github.com/johannesboyne/gofakes3 digest to ebf3e50 (#70) (02415a9)
  • deps: update module github.com/coreos/go-oidc/v3 to v3.17.0 (#117) (7b0febd)
  • deps: update module github.com/gin-contrib/zap to v1.1.6 (#123) (5036131)
  • deps: update module github.com/mcuadros/go-gin-prometheus to v1 (#94) (95dc12a)
  • deps: update module go.uber.org/zap to v1.27.1 (#115) (7390f46)
  • docs/reference/backblaze-b2-config.md: markdownlint-cli2 (4b21e96)

Contributors

Your contributions matter. Here's to everyone who's helped bring this to life.