Soft Serve
A tasty, self-hostable Git server for the command line. š¦
- Configure with
git
- Create repos on demand with
git push
- Browse repos with an SSH-accessible TUI
- Easy access control
- Allow/disallow anonymous access
- Add collaborators with SSH public keys
- Repos can be public or private
Where can I see it?
Just run ssh git.charm.sh
for an example.
Installation
Soft Serve is a single binary called soft
. You can get it from a package
manager:
# macOS or Linux
brew tap charmbracelet/tap && brew install charmbracelet/tap/soft-serve
# Arch Linux
yay -S soft-serve
You can also download a binary from the releases page. Packages are available in Alpine, Debian, and RPM formats. Binaries are available for Linux, macOS, and Windows.
Or just install it with go
:
go install github.com/charmbracelet/soft-serve/cmd/soft@latest
Setting up a server
Make sure git
is installed, then run soft
. Thatās it.
A Docker image is also available.
Configuration
The Soft Serve configuration is simple and straightforward:
# The name of the server to show in the TUI.
name: Soft Serve
# The host and port to listen on. Defaults to 0.0.0.0:23231.
host: localhost
port: 23231
# The access level for anonymous users. Options are: read-write, read-only
# and no-access.
anon-access: read-write
# You can grant read-only access to users without private keys.
allow-keyless: false
# Which repos should appear in the menu?
repos:
- name: Home
repo: config
private: true
note: "Configuration and content repo for this server"
- name: Example Public Repo
repo: my-public-repo
private: false
note: "A publicly-accessible repo"
- name: Example Private Repo
repo: my-private-repo
private: true
note: "A private repo"
# Authorized users. Admins have full access to all repos. Regular users
# can read all repos and push to their collab-repos.
users:
- name: Beatrice
admin: true
public-keys:
- KEY TEXT
- name: Frankie
collab-repos:
- my-public-repo
- my-private-repo
public-keys:
- KEY TEXT
When soft
is run for the first time, it creates a configuration repo
containing the main README displayed in the TUI as well as a config file for
user access control.
git clone ssh://localhost:23231/config
The config
repo is publicly writable by default, so be sure to setup your
access as desired. You can also set the SOFT_SERVE_INITIAL_ADMIN_KEY
environment variable before first run and it will restrict access to that
initial public key until you configure things otherwise.
Pushing (and creating!) repos
You can add your Soft Serve server as a remote to any existing repo:
git remote add soft ssh://localhost:23231/REPO
After youāve added the remote just go ahead and push. If the repo doesnāt exist on the server itāll be created.
git push soft main
The Soft Serve TUI
Soft Serve serves a TUI over SSH for browsing repos, viewing READMEs, and grabbing clone commands:
ssh localhost -p 23231
It's also possible to ālinkā to a specific repo:
ssh localhost -t -p 23231 REPO
Server Settings
In addition to the Git-based configuration above, there are a few environment-level settings:
SOFT_SERVE_PORT
: SSH listen port (default 23231)SOFT_SERVE_HOST
: SSH listen host (default 0.0.0.0)SOFT_SERVE_KEY_PATH
: SSH host key-pair path (default .ssh/soft_serve_server_ed25519)SOFT_SERVE_REPO_PATH
: Path where repos are stored (default .repos)SOFT_SERVE_INITIAL_ADMIN_KEY
: The public key that will initially have admin access to repos (default ""). This must be set beforesoft
runs for the first time and creates theconfig
repo. If set after theconfig
repo has been created, this setting has no effect.
License
Part of Charm.
Charmēē±å¼ęŗ ā¢ Charm loves open source