# Install git-pages with Homebrew, Nix

Scalable static site server for Git forges. Version 0.9.1 via Homebrew; verified 2026-05-31.

## Install

```sh
sudo av install brew:git-pages
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install git-pages
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#git-pages
```

  Evidence: nixpkgs package indexes: pkgs/by-name/gi/git-pages/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:git-pages
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/git-pages>
- **Version:** 0.9.1
- **Source summary:** Scalable static site server for Git forges
- **Homepage:** <https://codeberg.org/git-pages/git-pages>
- **Repository:** <https://codeberg.org/git-pages/git-pages>
- **Upstream docs:** <https://git-pages.org/>
- **License:** 0BSD
- **Source archive:** <https://codeberg.org/git-pages/git-pages/archive/v0.9.1.tar.gz>
- **Last updated:** 2026-05-31T16:11:52Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- git-pages (cli)
- git-pages (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.9.1
- Package-manager updated: 2026-05-31
- Local data: ok
- Upstream repository: https://codeberg.org/git-pages/git-pages
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

git-pages is a Go static-site server for Git forges, positioned by its maintainers as a GitHub Pages replacement that can run on ordinary infrastructure, scale horizontally, and store site data on a filesystem or S3-compatible object store.

### Project history

The public Codeberg repository was created in September 2025 under the git-pages organization, whose profile describes the project family as static-site server and publishing tools. The repository describes a server-centered design with optional Caddy integration for TLS, first-party container images, and companion publishing tools for users who want to publish to a hosted Pages service.

Release tags show a rapid early sequence from v0.1.0 in November 2025 through v0.9.x in 2026. The README records a migration from an original filesystem architecture to a v2 architecture based around manifests and object storage, reflecting an evolution from a simple local tree layout toward backends better suited to S3-style storage.

### Adoption history

The project is young compared with older Git workflow utilities, but it gained package-manager coverage through Homebrew and Nix and documents packaged binaries, containers, and source installation. Codeberg metadata shows hundreds of stars, which is notable for a specialized static-site hosting server tied to Forgejo/Gitea-style workflows.

### How it is used

Practitioners use git-pages by running the server, publishing a repository or archive to it through HTTP methods, and serving the branch or uploaded archive as a static site. The README emphasizes the pages branch, Forgejo/Gitea/Gogs/GitHub webhook payloads, DNS-based authorization, optional Caddy TLS, and filesystem or S3-compatible storage.

Operators care about it as infrastructure rather than a desktop helper: configuration, credentials, authorization policy, object-store behavior, metrics, syslog, and atomic updates are part of the normal operating surface.

### Why package nerds care

For package-index users, git-pages is interesting because it turns the familiar Pages pattern into a self-hostable service with a small Go binary, container images, and Nix/Homebrew packaging. Its README also points to related first-party packages such as git-pages-cli and a Forgejo Action, making it part of a small publishing ecosystem rather than a single executable.

### Timeline

- 2025: Codeberg repository created under the git-pages organization.
- 2025: v0.1.0 tag published.
- 2025: v0.3.x release notes introduced TOML config output and site diagnostics.
- 2026: v0.8.x and v0.9.x release notes focused on authorization and Caddy-related security fixes.

### Related projects

- git-pages-cli is the companion client for publishing to a git-pages service.
- git-pages/action is a Forgejo Action for publishing from forge workflows.
- Caddy is documented as the recommended TLS front end for the server.

### Sources

- <https://codeberg.org/api/v1/repos/git-pages/git-pages>
- <https://codeberg.org/git-pages/git-pages>
- <https://codeberg.org/git-pages/git-pages/releases>
- <https://git-pages.org/>


## Security Notes

No matching local secret-handling manifest was found for git-pages. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ./config.toml, /etc/git-pages/config.toml

## Credential files

- Unix: $CREDENTIALS_DIRECTORY/secrets.toml, /etc/git-pages/secrets.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** git-pages
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - git-pages: normalized package name match | nixpkgs package indexes: pkgs/by-name/gi/git-pages/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [git-pages-cli](https://www.automicvault.com/pkg/brew/git-pages-cli/) - Package name indicates the same formula family.
- [git-pkgs](https://www.automicvault.com/pkg/brew/git-pkgs/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extension, version-control.
- [git-plus](https://www.automicvault.com/pkg/brew/git-plus/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extension, version-control.
- [git-quick-stats](https://www.automicvault.com/pkg/brew/git-quick-stats/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extension, version-control.
- [git-recent](https://www.automicvault.com/pkg/brew/git-recent/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extension, version-control.
- [git-remote-codecommit](https://www.automicvault.com/pkg/brew/git-remote-codecommit/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extension, version-control.
- [git-revise](https://www.automicvault.com/pkg/brew/git-revise/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extension, version-control.
- [forgejo-cli](https://www.automicvault.com/pkg/brew/forgejo-cli/) - Shares av.db curated category or tags: cli, developer-tools, forgejo, git, version-control.
- [gcli](https://www.automicvault.com/pkg/brew/gcli/) - Shares av.db curated category or tags: cli, developer-tools, forgejo, git, version-control.
- [codeberg-cli](https://www.automicvault.com/pkg/brew/codeberg-cli/) - Local package facts share a topical domain. Shared terms: cli, control, developer, developer-tools, git.

## Combined YAML source

View the package source record on GitHub. [combined/git-pages.yml](https://github.com/automic-vault/db/blob/main/combined/git-pages.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
