Getting Started

GitForge is a Git hosting platform built for teams that work with large binary files. This guide will get you up and running in under five minutes.

Choose Your Path

Git (CLI)

Use standard Git commands. Clone, push, pull — works with any Git client.

SDK

Programmatic access via TypeScript, Python, or Go client libraries.

CLI Tool

The gf command-line tool for repo management and automation.

1. Create an Account

Sign up at gitforge.dev/signup with your email or GitHub account. Free tier includes unlimited bandwidth, 5 GB storage, and up to 100 repositories.

2. Create a Repository

Create a new repository from the dashboard or use the API:

Create via API

curl -X POST https://api.gitforge.dev/api/repos \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-project", "description": "My first repo"}'

Or create one from the web dashboard.

3. Clone and Push

Use a Personal Access Token (PAT) for authentication. Generate one from your account settings.

Clone with PAT

git clone http://x:[email protected]/your-org/my-project.git
cd my-project

Push your first commit

echo "# My Project" > README.md
git add README.md
git commit -m "Initial commit"
git push origin main

4. Enable Git LFS

GitForge has built-in LFS support. Track large binary files without any extra server configuration:

Track large files

git lfs install
git lfs track "*.psd" "*.fbx" "*.uasset"
git add .gitattributes
git add assets/
git commit -m "Add binary assets via LFS"
git push origin main

5. SDK Quick Start

Install the SDK for your language to interact with GitForge programmatically:

TypeScript

npm install @gitforge/sdk

import { GitForge } from "@gitforge/sdk";

const gf = new GitForge({ token: "gf_YOUR_PAT" });
const repos = await gf.repos.list();
console.log(repos);

Python

pip install gitforge-sdk

from gitforge import GitForge

gf = GitForge(token="gf_YOUR_PAT")
repos = gf.repos.list()
print(repos)

go get github.com/gitforge/gitforge-go

package main

import (
    "fmt"
    gitforge "github.com/gitforge/gitforge-go"
)

func main() {
    client := gitforge.NewClient("gf_YOUR_PAT")
    repos, _ := client.Repos.List()
    fmt.Println(repos)
}

Next Steps

Interactive Setup Wizard — Guided walkthrough in your dashboard →API Reference — Full REST API documentation →API Explorer — Try API endpoints interactively →SDKs — Detailed SDK guides for all languages →CLI — Command reference for the gf tool →Webhooks — Set up real-time event notifications →