charmbracelet/soft-serve
Soft Serve
Soft Serve is a self-hosted Git server that authenticates users via SSH public keys and provides a terminal-based user interface for browsing repositories, files, and commits. It stores repository data and configuration in either SQLite or PostgreSQL, and supports role-based access control with four permission levels for managing repository visibility and write access.
The server can be deployed via Docker or managed as a systemd service, and supports webhook notifications for push, collaborator, and branch or tag events to integrate with external automation workflows. It also enables server-side Git hook execution for custom pre- and post-push scripts, and provides HTTP access token generation for authenticated HTTP operations.
Additional capabilities include anonymous repository cloning over HTTP and the native Git protocol, Git LFS object serving, automatic repository creation on push, and remote repository mirroring from public remotes. Repository management—including creation, renaming, deletion, import, and collaborator administration—is performed through SSH command-line interactions.
Features
- Git SSH Servers - Hosts Git repositories accessible via SSH for cloning, pushing, and browsing.
- Git Hook Scripts - Executes custom scripts before or after pushes to automate tasks like continuous integration.
- SQLite or PostgreSQL Storage - Stores all repository data and configuration in either SQLite or PostgreSQL databases.
- Git Repository Managers - Creates, clones, and administers Git repositories with role-based access control over SSH.
- Repository Administration Commands - Creates, renames, deletes, imports, and configures repositories via SSH commands.
- Custom Script Executions - Provides server-side execution of custom scripts on push events with flexible configuration.
- Self-Hosted Git Services - Sets up and manages a private Git server with SSH access, user authentication, and repository permissions.
- Webhook-Enabled Git Servers - A Git server that registers webhooks and triggers custom scripts on push events for CI/CD automation.
- Private Repository Access Controls - Controls repository access with four levels: no-access, read-only, read-write, and admin.
- Role-Based Access Control - Assigns read-only, read-write, or admin access levels to users and restricts visibility.
- SSH Authentication - Authenticates users via SSH public keys for secure server access.
- SSH Key Management - Manages user access using SSH public key authentication with role-based permissions and key deduplication.
- Push-Triggered Repository Creations - Automatically creates repositories when pushing to a non-existent remote.
- Terminal-Based Repository Navigators - Browses Git repositories, files, and commit history through an interactive terminal user interface over SSH.
- Webhook and Hook Automation - Registers webhooks and runs custom server-side Git hooks on push events for CI/CD automation.
- Anonymous Repository Cloning - Provides read-only access to repositories through HTTP and the native Git protocol for anonymous cloning.
- Collaborator Permission Managers - Adds collaborators to restrict write access to specific repositories.
- Docker Container Deployments - Runs the Git server inside a Docker container with a mounted volume for persistent storage.
- Git Large File Storage - Serves large files via Git LFS over both HTTP and SSH protocols.
- Systemd Services - Manages the Git server as a background service that starts on boot and restarts on failure.
- SSH Repository Browsers - Connects to a Git server via SSH and navigates repositories using keyboard-driven TUI controls.
- Webhook Event Notifications - Posts notifications to external services for pushes, collaborator changes, and branch or tag events.
- Event Webhook Management - Registers webhooks that notify external services when repository events like pushes occur.
- Terminal User Interfaces - Provides an interactive terminal-based interface for browsing repositories, files, and commits.
- Development Environments - Self-hostable Git server for the command line.
- Development Tools - Self-hostable Git server for the command line.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
