⚠️ This repository is maintained by one person, in their spare time, with no funding, no team, and zero external support.

Every package and update is built and published for free. If these packages save you time, please consider supporting the project.

Buy me a coffee

⚒️ Install Latest Forgejo on Debian

Self-hosted lightweight software forge — Beyond coding. We forge.

Buy me a coffee
← Back to home

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.

🚀 Why Latest Versions Matter: Forgejo receives regular updates with security patches, new features, and performance improvements. The latest releases include Forgejo Actions (GitHub Actions-compatible CI/CD), improved package registry support, and enhanced federation capabilities.

⚡ 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

📦 Installation from debian.griffo.io

Step 1: Add Repository

curl -sS https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/trusted.gpg.d/debian.griffo.io.gpg echo "deb https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/debian.griffo.io.list sudo apt update
curl -sS https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/trusted.gpg.d/debian.griffo.io.gpg echo "deb https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/debian.griffo.io.list apt update

Step 2: Install Forgejo

# Install latest Forgejo (also installs git and git-lfs) sudo apt install forgejo # Verify installation forgejo --version
# Install latest Forgejo (also installs git and git-lfs) apt install forgejo # Verify installation forgejo --version
📋 Post-install setup required: Forgejo is a web server — after installation you need to start it and complete the initial configuration through the web interface. See the setup steps below.

🚀 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:

# Start the Forgejo service sudo systemctl start forgejo # Open http://localhost:3000 in your browser to complete initial configuration # (configure database, admin account, domain, etc.) # After the web setup is complete, enable Forgejo on boot: sudo systemctl enable forgejo # Check service status sudo systemctl status forgejo

🛡️ Post-Configuration Security Hardening

After completing the web-based setup, make the config file read-only for added security:

# Lock down the config directory and app.ini after initial configuration sudo systemctl stop forgejo sudo chmod 750 /etc/forgejo sudo chmod 640 /etc/forgejo/app.ini sudo systemctl start forgejo

🔧 Command-Line Administration

Forgejo provides a CLI for administration tasks. Run commands as the git user:

# List all users sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user list # Create admin user sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin user create \ --username admin --password changeme --email admin@example.com --admin # Regenerate Git hooks (useful after upgrades) sudo -u git forgejo -w /var/lib/forgejo -c /etc/forgejo/app.ini admin regenerate hooks

🚀 Why Choose debian.griffo.io?

📊 Repository Comparison:
  • 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

📦 Package Build Repository

The Debian packages are automatically built and maintained in this GitHub repository:

🔗 Related Packages

Also available from debian.griffo.io:

🎯 Perfect for: Developers and teams who want full control over their source code, organizations with data privacy requirements, homelab enthusiasts, anyone looking for a self-hosted GitHub/GitLab alternative that's lightweight enough to run on minimal hardware.

💝 Support This Project

If this repository saves you time and effort, please consider supporting it!

⭐ Star on GitHub 🐦 Share on Twitter Buy me a coffee