GitForest Documentation

Everything you need to install, use, and understand GitForest — decentralized P2P git hosting.

Installation

Binaries, the one-line script, .deb packages, PATH setup, verification, and upgrades.

Getting Started & CLI

Identity, adding repos, the daemon, cloning peer-to-peer, and the full CLI reference.

Large File Storage (LFS)

Content-addressed blobs, adaptive chunking, collections, and pointer files.

Compute Marketplace

Decentralized CI/CD: submitting jobs, running workers, and getting paid in crypto.

Architecture

GitForest is a Rust workspace of focused crates, all compiled into two binaries (gitforest and git-remote-gitforest) plus the gtfo alias:

git clone gitforest://<peer_id>/<repo>
      |
      v
git-remote-gitforest  -->  gitforest daemon
(custom git transport)     |
                           +-- DHT Node (libp2p Kademlia + mDNS)
                           +-- Git Protocol server (port 9419)
                           +-- Compute Runner (Docker)
                           +-- HTTP API + Web UI (127.0.0.1:7878)

gt-core — identity (Ed25519), config, protocol messages
gt-dht — libp2p Kademlia + mDNS discovery
gt-transport — git bundles, smart protocol bridge, piece verification
gt-collab — signed patches, fork + merge requests, ACLs
gt-compute — P2P compute marketplace, Docker runner, crypto payments
gt-lfs — content-addressed blobs, adaptive chunking, collections
gt-daemon — main binary: CLI, HTTP API, network management
gt-remote — the git-remote-gitforest git remote helper
gt-web — embedded web dashboard

Source & project

github.com/NPC-Worldwide/git-forest — source code (AGPL-3.0)
Releases — changelogs, checksums, source archives
github.com/NPC-Worldwide/gitforest-web — this website's source

Start with Installation Download binaries