# Forgejo: Git server **Who can use this:** Everyone with or without an account on our server. [https://git.necc.me](https://git.necc.me/) # Forgejo on Our Home Server — A Friendly Guide Short version: Our home server now runs Forgejo, a place where we keep saved copies of files and code, with a history of every change. You don't need to be a tech person to look around — you can browse everything without logging in (top left "Explore"). To log in, use the top right "Login" button, which goes through Authentik (the same login you use for Bookstack and everything else on this server). If you see a red "HTTP 500" error after logging in, it is a known bug — ignore it, you *are* logged in. Just go back, or clean up the address bar. --- ## What is Git? (In plain words) Think of Git like a time machine for your files. - Every time you change a file and "save it to Git," it makes a snapshot — like a photo of the file at that moment. - You can look back and see who changed what, and when. - If you make a mistake, you can go back to an older version safely. - If two people work on the same file, Git helps them combine their changes without overwriting each other. ## Why we host Git on our own server Running Forgejo on our own machine (instead of using GitHub or a similar service) has a few clear benefits: - **Privacy:** Your files never leave our server. No outside company can scan, read, or sell your data. - You are free to host private repositories. - **No limits or prices:** No ads, no subscription fees, no "you have used too much storage" emails. - **You are in control:** We decide who can see what, when updates happen, and how backups work. No one else can shut it down or change the rules. ## A quick note: this is for advanced users **Please read this before using Forgejo.** Git and Forgejo are tools for people who write code or manage server settings. This documentation is intentionally simple and limited — it only explains the basics for non-tech users. --- ## What is on this Forgejo instance? - This instance hosts public repositories that are used to run the services on our home server. - This was added as an afterthought, so it is limited right now. - It is a long-term work in progress. --- ## How to use Forgejo ### 1. Just looking around? No login needed. - Open [`https://git.necc.me`](https://git.necc.me) in your browser. - Click **"Explore"** in the **top left corner**. - You can now browse all the public repositories. That's it! ### 2. Need to log in? - Click **"Login"** in the **top right corner**. - You will be redirected to Authentik. ### 3. "HTTP 500" error This is a **known bug in the current version (v16)**. **Y****ou ARE logged in**, the error is just a display problem. To fix the screen, do **one** of these: - Click **"Go back"** in your browser, **or** - In the address bar (top of the browser), **delete everything after the last `/`** in `git.necc.me` — so the address becomes just: `https://git.necc.me/` - Press **Enter**. You should now see the normal Forgejo page.