Welcome to Forgejo

Fork Overview

This is a fork of Forgejo maintained at v14.0.2 with custom development tooling and configuration.

Repository: forge.ourworld.tf/lhumina_research/forgejo_fork.git Upstream: https://codeberg.org/forgejo/forgejo.git (remote: upstream) Language: Go | Binary: ./gitea

Quick Start

# Complete setup: builds, starts PostgreSQL, configures, and creates admin user
make devreset

# Visit http://localhost:3333 with credentials below

Login Credentials:

• Username: administrator
• Password: password1234
• Email: admin@example.com

Development Workflow

# Start Forgejo in background (PostgreSQL + configure)
make rundev

# Create the default admin user (if needed separately)
make user

# Stop Forgejo
pkill -f 'forgejo -w'

Defaults

• HTTP Port: 3333
• SSH Port: 2299
• MCP Port: 4856
• Database: PostgreSQL on localhost:5432
• Admin User: administrator / password1234
• Admin Email: admin@example.com
• Root Directory: /tmp/forgeo
• Config File: custom/conf/app.ini

Build Notes

• macOS: Uses LDFLAGS="" to avoid PostgreSQL linker conflicts
• Requirements: Go >= 1.25.0, Node >= 22
• Tags: bindata embeds frontend assets into the binary

MCP Server - Model Context Protocol

The fork includes an MCP (Model Context Protocol) Server that exposes Forgejo functionality for AI agents and tools.

Start MCP Server

# 1. Get an API token
export FORGEJO_TOKEN=your_token_here

# 2. Start the MCP server (from mcp/server directory)
cd mcp/server
./mcp_start.sh

# Server runs on port 4856
# Health check: curl http://localhost:4856/health

Connect to MCP Server

Endpoint: http://localhost:4856/sse

From Python:

import requests

# Check health
response = requests.get("http://localhost:4856/health")
print(response.text)  # "OK"

# Call a Forgejo tool
message = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "forgejo_list_repos",
        "arguments": {}
    }
}
response = requests.post("http://localhost:4856/message", json=message)
print(response.json())

From Node.js:

// Health check
fetch("http://localhost:4856/health")
  .then(r => r.text())
  .then(data => console.log("Health:", data));

// List repos via MCP
const message = {
  jsonrpc: "2.0",
  id: 1,
  method: "tools/call",
  params: {
    name: "forgejo_list_repos",
    arguments: {}
  }
};
fetch("http://localhost:4856/message", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(message)
})
.then(r => r.json())
.then(data => console.log("Response:", data));

From Bash:

# Health check
curl http://localhost:4856/health

# SSE connection (real-time)
curl -N http://localhost:4856/sse

# Send message
curl -X POST http://localhost:4856/message \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"forgejo_list_repos","arguments":{}}}'

From Claude Code:

• Endpoint: http://localhost:4856/sse
• All Forgejo tools automatically available

MCP Commands

cd mcp/server

./mcp_start.sh         # Start MCP server
./mcp_start.sh --status  # Check status
./mcp_start.sh --logs   # View logs
./mcp_start.sh --stop   # Stop server

Available MCP Tools

The MCP server exposes 60+ tools for:

• Repositories (10+): list, get, create, search
• Organizations (10+): list, create, manage projects
• Projects (20): repository and organization projects
• Issues (10+): list, get, create, update
• Labels (10+): list, create, manage
• Users (10+): get user info, list users
• And more...

See docs/api_extra.md for complete tool reference.

Forgeo Intro

Hi there! Tired of big platforms playing monopoly? Providing Git hosting for your project, friends, company or community? Forgejo (/for'd͡ʒe.jo/ inspired by forĝejo – the Esperanto word for forge) has you covered with its intuitive interface, light and easy hosting and a lot of built-in functionality.

Forgejo was created in 2022 because we think that the project should be owned by an independent community. If you second that, then Forgejo is for you! Our promise: Independent Free/Libre Software forever!

What does Forgejo offer?

If you like any of the following, Forgejo is literally meant for you:

• Lightweight: Forgejo can easily be hosted on nearly every machine. Running on a Raspberry? Small cloud instance? No problem!
• Project management: Besides Git hosting, Forgejo offers issues, pull requests, wikis, kanban boards and much more to coordinate with your team.
• Publishing: Have something to share? Use releases to host your software for download, or use the package registry to publish it for docker, npm and many other package managers.
• Customizable: Want to change your look? Change some settings? There are many config switches to make Forgejo work exactly like you want.
• Powerful: Organizations & team permissions, CI integration, Code Search, LDAP, OAuth and much more. If you have advanced needs, Forgejo has you covered.
• Privacy: From update checker to default settings: Forgejo is built to be privacy first for you and your crew.
• Federation: (WIP) We are actively working to connect software forges with each other through ActivityPub, and create a collaborative network of personal instances.

Learn more

Dive into the documentation, subscribe to releases and blog post on our website, find us on the Fediverse or hop into our Matrix room if you have any questions or want to get involved.

License

Forgejo is distributed under the terms of the GPL version 3.0 or any later version.

The agreement for this license was documented in June 2023 and implemented during the development of Forgejo v9.0. All Forgejo versions before v9.0 are distributed under the MIT license.

Get involved

If you are interested in making Forgejo better, either by reporting a bug or by changing the governance, please take a look at the contribution guide.