# Install soft-serve with Homebrew, Nix, pacman, winget Mighty, self-hostable Git server for the command-line. Version 0.11.6 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:soft-serve ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install soft-serve ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#soft-serve ``` Evidence: nixpkgs package indexes: pkgs/by-name/so/soft-serve/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S soft-serve ``` Evidence: Arch Linux sync databases: soft-serve from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz ### Windows - winget (92%): ```sh winget install --id charmbracelet.soft-serve -e ``` Evidence: Windows Package Manager source index: charmbracelet.soft-serve from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:soft-serve - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.11.6 - **Source summary:** Mighty, self-hostable Git server for the command-line - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - soft (cli) - soft (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.11.6 - Local data: ok - Upstream repository: https://github.com/charmbracelet/soft-serve - info: No package-manager update timestamp was available. - info: No cached GitHub release or tag data was available. ## Project history and usage Soft Serve is Charm's self-hostable Git server for the command line, combining Git-over-SSH/HTTP/Git protocol serving with an SSH-accessible terminal UI and administrative command set. ### Project history Charmbracelet created the Soft Serve GitHub repository in July 2021, and its v0.1.0 release followed in December 2021. The first release changelog already shows the project's core ideas: a Bubble Tea terminal UI, SSH middleware, repository browsing, clone information, public/private repository settings, config-as-data work, and packaged release artifacts. The current README presents Soft Serve as a single binary named soft. It can create repositories on demand, import mirrors, browse repositories over SSH, print files with syntax highlighting, serve Git LFS, manage users and access through SSH commands, and run as a service or container. Soft Serve fits Charm's broader terminal-app ecosystem. It uses the same Go/TUI culture as Charm projects such as Bubble Tea, Lip Gloss, Wish, and Glamour, making Git hosting feel like an interactive CLI application rather than only a web service. ### Adoption history The README documents installation through Homebrew, winget, Arch, Nix, Debian/Ubuntu and Fedora/RHEL package repositories, Go install, GitHub releases, and Docker images. That multi-channel distribution is central to its adoption story because a self-hosted Git server needs to be easy to bootstrap on small machines and developer boxes. GitHub metadata shows a sizeable open-source audience for a niche Git server, and later releases in 2025 and 2026 focused on security fixes, LFS behavior, UI stack updates, CORS, and operational hardening. ### How it is used A typical first run is soft serve, which creates a data directory containing repositories, SSH keys, database files, and config.yaml. Administrators set SOFT_SERVE_INITIAL_ADMIN_KEYS for initial access and can override the data path with SOFT_SERVE_DATA_PATH. Day-to-day use happens through normal git clone and git push commands plus SSH subcommands such as repo create, repo import, repo tree, repo blob, user create, pubkey add, token create, and settings management. Users can also SSH into the server for the TUI. ### Why package nerds care Soft Serve is package-nerd-interesting because it compresses a Git hosting appliance into one Go binary with predictable config and data directories. That makes it attractive for homelabs, internal mirrors, demos, workshops, and small teams that do not need a full forge. It also shows the modern CLI preference for SSH-native administration: package the daemon, expose a stable service, and let git and ssh remain the primary clients. ### Timeline - 2021-07: GitHub repository created under charmbracelet/soft-serve. - 2021-12: v0.1.0 released with the early Git server, SSH, TUI, and packaging work. - 2025: v0.9.0 updates the UI stack to newer Bubble Tea, Lip Gloss, Bubbles, Glamour, and Wish versions. - 2026: v0.11.x releases include security fixes around authentication, SSRF checks, and LFS behavior. ### Related projects - Git: the version-control protocol and repository format Soft Serve hosts. - Git LFS: supported by Soft Serve over HTTP and SSH backends. - Bubble Tea, Lip Gloss, Glamour, and Wish: Charm libraries used in the terminal UI and SSH application style. - Gitea, Forgejo, GitLab, and cgit: neighboring Git hosting choices with different weight and interface assumptions. ### Sources - current_curation.config-file-location - - - - - source_facts.package-manager ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## 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: $SOFT_SERVE_DATA_PATH/config.yaml, data/config.yaml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** soft-serve - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - soft-serve: normalized package name match | nixpkgs package indexes: pkgs/by-name/so/soft-serve/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman - soft-serve - 0.11.6-2: normalized package name match | Arch Linux sync databases: soft-serve from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A self-hosted Git server for the command line | https://github.com/charmbracelet/soft-serve - winget - charmbracelet.soft-serve: normalized package name match | Windows Package Manager source index: charmbracelet.soft-serve from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [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. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [diffnav](https://www.automicvault.com/pkg/brew/diffnav/) - Shares av.db curated category or tags: cli, developer-tools, git, tui, version-control. - [git-pages](https://www.automicvault.com/pkg/brew/git-pages/) - Shares av.db curated category or tags: cli, developer-tools, git, server, version-control. - [gitea](https://www.automicvault.com/pkg/brew/gitea/) - Shares av.db curated category or tags: cli, developer-tools, git, self-hosted, version-control. - [gitu](https://www.automicvault.com/pkg/brew/gitu/) - Shares av.db curated category or tags: cli, developer-tools, git, tui, version-control. - [gitui](https://www.automicvault.com/pkg/brew/gitui/) - Shares av.db curated category or tags: cli, developer-tools, git, tui, version-control. - [serie](https://www.automicvault.com/pkg/brew/serie/) - Shares av.db curated category or tags: cli, developer-tools, git, tui, version-control. - [aicommit](https://www.automicvault.com/pkg/brew/aicommit/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control. - [aicommit2](https://www.automicvault.com/pkg/brew/aicommit2/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control. - [git-cal](https://www.automicvault.com/pkg/brew/git-cal/) - Local package facts share a topical domain. Shared terms: cli, command-line, control, developer, developer-tools. - [git-delete-merged-branches](https://www.automicvault.com/pkg/brew/git-delete-merged-branches/) - Local package facts share a topical domain. Shared terms: cli, command-line, control, developer, developer-tools. ## Combined YAML source View the package source record on GitHub. [combined/soft-serve.yml](https://github.com/automic-vault/db/blob/main/combined/soft-serve.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