What is Forgejo?
Forgejo is a self-hosted lightweight software forge. Easy to install and low maintenance, it just does the job. Forgejo is a community-driven fork of Gitea focused on security, privacy, and democratic governance — giving you a self-hosted alternative to GitHub or GitLab that you fully control.
⚡ Key Features of Forgejo
📦 Git Repository Hosting
Host unlimited public and private git repositories. Full support for Git LFS, large file storage, and repository mirroring from GitHub, GitLab, and more.
🔄 Pull Requests & Code Review
Built-in pull request workflow with inline code review, review assignments, required reviewers, and merge strategies including squash and rebase.
🐛 Issue Tracking
Full-featured issue tracker with labels, milestones, projects board, custom fields, and cross-repository references.
⚙️ Forgejo Actions
Built-in CI/CD engine compatible with GitHub Actions workflows. Use existing GitHub Actions marketplace actions on your self-hosted runner.
📚 Package Registry
Host your own packages: npm, PyPI, Maven, Docker/OCI images, Debian/RPM packages, Helm charts, and more — all in one place.
🔐 Security & Access Control
Fine-grained permissions, two-factor authentication, OAuth2 provider, LDAP/SAML integration, SSH and HTTPS access, branch protection rules.
🏆 Why Forgejo?
- Self-hosted: Your data stays on your servers, under your control
- Lightweight: Runs on a Raspberry Pi or a $5/month VPS
- Gitea compatible: Drop-in replacement with full API compatibility
- Community-driven: Democratic governance, no corporate lock-in
- GitHub Actions compatible: Reuse existing workflows and marketplace actions
🆕 What's New in Forgejo 15.0.2
- Forgejo Actions: Enhanced CI/CD with improved runner compatibility
- Package Registry: Extended support for package formats
- Security Fixes: Latest security patches and hardening
- Performance: Database query optimizations and reduced memory usage
- Federation: Improved ActivityPub federation support
📦 Installation from debian.griffo.io
Step 1: Add Repository
Step 2: Install Forgejo
🚀 Initial Setup
The package automatically creates the git system user, the /var/lib/forgejo data directory, and the /etc/forgejo config directory. Complete the setup with:
🛡️ Post-Configuration Security Hardening
After completing the web-based setup, make the config file read-only for added security:
🔧 Command-Line Administration
Forgejo provides a CLI for administration tasks. Run commands as the git user:
🚀 Why Choose debian.griffo.io?
- Official Debian: No Forgejo package available in official repos
- Manual install: Requires downloading and placing binary manually
- debian.griffo.io: Latest version (15.0.2+) with proper packaging, postinst setup, and apt update support
- ✅ Latest Security Patches: Always get the newest Forgejo release
- ✅ Automatic Setup: Post-install script creates user, directories, and systemd service
- ✅ Proper Dependencies: git and git-lfs installed automatically
- ✅ Automatic Updates:
apt upgradekeeps Forgejo current - ✅ Multi-Architecture: Supports amd64, armhf (Raspberry Pi), and arm64
- ✅ Multi-Distribution: Works on Bookworm, Trixie, and Sid
📦 Package Build Repository
The Debian packages are automatically built and maintained in this GitHub repository:
- ⚒️ forgejo-debian - Latest release builds
🔗 Related Packages
Also available from debian.griffo.io:
- lazygit - Terminal UI for Git (great companion for git workflows)
- lazydocker - Terminal UI for Docker (useful if running Forgejo in containers)
- eza - Modern ls replacement
💝 Support This Project
If this repository saves you time and effort, please consider supporting it!