CandyServe
Self-hostable Git server over SSH + Git + HTTP
Self-hostable Git server with SSH (authorized keys), Git (git://), and HTTP endpoints. Users, repos, access control, and optional LFS — all driven by a config file.
Install
composer require sugarcraft/candy-serveQuickstart
use SugarCraft\Serve\{Config, Repo, SSH\SSHServer};
// Load config
$config = Config::fromDefaults();
// Create a repo
$repo = Repo::create($config, 'my-project');
echo "Repo path: {$repo->path()}\n";
// Spawn the SSH server
$server = new SSHServer($config);
$server->listen();What's in the box
SSH endpointAuthorized-key authentication, git upload-pack / receive-pack.
Git daemonUnauthenticated git:// protocol endpoint.
HTTP endpointDumb HTTP gateway for behind-firewall access.
Access controlPer-repo read/write/user grants and denials.
LFS supportOptional LFS handler for large file storage.
Config fileYAML-based server configuration.
Source & demos
- Source on GitHub
- Full README
- Runnable examples
- Port of charmbracelet/soft-serve (Go upstream)
API
| Class | Method | Description |
|---|---|---|
| Config | fromDefaults() | Create default configuration |
| Config | fromYaml(path) | Load configuration from YAML |
| Repo | create(config, name) | Create a new repository |
| Repo | path() | Get repository path |
| SSHServer | new(config) | Create SSH server |
| SSHServer | listen() | Start listening for connections |
| GitDaemon | new(config) | Create Git daemon |
| HttpServer | new(config) | Create HTTP server |
