Slik installerer du Gitea for å ha en lokal Git-server

Siste oppdatering: 3 september 2026
Forfatter: TecnoDigital
  • Gitea er et lettvektsalternativ til GitLab og GitHub som bruker svært få systemressurser.
  • Installasjonen er basert på en kjørbar binærfil som administreres som en tjeneste gjennom SystemD.
  • Det er viktig å bruke en omvendt proxy med Nginx for å muliggjøre sikker tilgang via HTTPS.
  • Det tillater migrering av eksisterende repositorier fra andre plattformer samtidig som problemer og tagger opprettholdes.

Serverracks i et datasenter, som representerer infrastrukturen til en lokal Git-server.

Hvis du er lei av å stole på reglene, kostnadene eller tilgjengeligheten til giganter som GitHub eller GitLab, er det å bygge din egen infrastruktur veien videre. Å ha en Git-server hjemme eller på ditt eget kontor gir deg nøklene til riket: absolutt kontroll over koden , total tilgangsstyring og tryggheten ved å ikke ha tredjepartsbegrensninger på dine private repositorier.

Blant alle tilgjengelige alternativer skiller Gitea seg ut som en perle. Det er et verktøy skrevet i Go, noe som gjør det utrolig lett og raskt , ideelt for de som ikke ønsker å dedikere 16 GB RAM til en Git-server. I motsetning til GitLab, som er et funksjonsrikt, men ressurskrevende havskip, er Gitea som en speedbåt: det går rett på sak, bruker svært få ressurser og tilbyr et veldig kjent grensesnitt for alle som har brukt GitHub.

Rask sammenligning: Gitea, GitLab og Forgejo

Programvareingeniør konfigurerer en server ved hjelp av en bærbar PC i et serverrom.

Før du går i gang med installasjonen, er det verdt å vite hva du går inn på. GitLab er det perfekte alternativet for bedrifter, ideelt for store team som trenger integrert CI/CD, men det krever kraftig maskinvare. Gitea, derimot, er det beste valget for beskjedne servere eller personlige prosjekter på grunn av det svært lille minneavtrykket. Til slutt har vi Forgejo, en fellesskapsforgrening av Gitea. Hvis du er en purist av fri programvare og foretrekker åpen styring uten bedriftsmessige overtoner, er dette alternativet for deg.

  Hva er en server og hvordan den fungerer: Typer og egenskaper

Det du trenger før du starter

Bærbar datamaskin som viser kodelinjer i et moderne arbeidsområde, ideelt for å illustrere administrasjon av Git-repositorier.

For å sikre at alt går knirkefritt, sørg for at du har en Linux-server (enten Ubuntu, Debian eller Rocky Linux) med root-tilgang. Det er også viktig å ha Git installert på maskinen, og selv om Gitea tillater bruk av SQLite, anbefales PostgreSQL eller MariaDB på det sterkeste for produksjonsmiljøer for å garantere datastabilitet.

Forberede grunnen i systemet

Nærbilde av hender som programmerer på et tastatur, som representerer programvareutvikling og bruk av Gitea.

Av sikkerhetsmessige årsaker er det ikke lurt å kjøre Gitea som root. Det er best å opprette en dedikert bruker. Du kan gjøre dette ved å kjøre kommandoen adduser --system --shell /bin/bash --group --home /home/gitea giteaDet er viktig å bruke /bin/bash som skall fordi Gitea må samhandle med git-shell via SSH. Hvis du ikke allerede har Git installert, er en enkel apt install git vil løse problemet raskt.

Binærinstallasjon og mappestruktur

Detalj av Ethernet-kabler koblet til en nettverkssvitsj, som illustrerer nettverkskonfigurasjonen og omvendt proxy.

Gitea kan installeres på flere måter, men binærfilen er den enkleste. Du bør finne den nyeste stabile versjonen på den offisielle nettsiden og laste den ned ved hjelp av [method/method]. wget en /usr/local/bin/giteagir det senere utfør tillatelser med chmod +xFor at programmet skal fungere riktig, må en rekke spesifikke kataloger opprettes: /etc/gitea for konfigurasjon og /var/lib/gitea for tilpassede data, logger og filer. Ikke glem å justere eiendomstillatelser (chown) slik at brukeren gitea kan skrive til dem.

Databasekonfigurasjon

Hvis du velger PostgreSQL, må du installere pakken og opprette en spesifikk rolle med et sterkt passord, i tillegg til databasen. giteadb med UTF8-koding. Hvis du foretrekker MariaDB, er prosessen lik: du oppretter databasen og brukeren, og sørger for at lagringsmotoren er InnoDB og at serveren lytter på port 3306.

  MCP-serverstøtte i et GNOME-miljø: en komplett guide

Automatisering med SystemD

For å unngå å måtte starte Gitea manuelt hver gang du starter serveren på nytt, er det best å opprette en stasjonsfil i /etc/systemd/system/gitea.serviceDenne filen forteller systemet at Gitea må kjøres som en tjenestedefinerer bruker-, gruppe- og binærbanen. Når den er opprettet, kjører du den systemctl enable --now gitea og serveren vil begynne å lytte, som standard, på port 3000.

Den første kontakten med webgrensesnittet

Al entrar no http://tu-ip:3000Deretter vil du møte oppsettveiviseren. Det er her du kobler til databasen (angir vert, brukernavn og passord) og definerer generelle nettstedinnstillinger, som for eksempel forekomstnavnet og basis-URL-en. Det er også på tide å konfigurere SSH-serveren og bestemme om du vil at hvem som helst skal kunne registrere seg, eller om du foretrekker... deaktiver offentlig logging for å holde serveren privat.

Sikkerhet og profesjonell tilgang med Nginx

Det er ineffektivt og usikkert å få tilgang til Gitea via port 3000. Den ideelle løsningen er å sette opp en omvendt proxy med Nginx . Dette lar brukere få tilgang til nettstedet via et domene (f.eks. git.dittdomene.com) og sikrer at all trafikk krypteres ved hjelp av Let's Encrypt SSL-sertifikater . I Nginx-konfigurasjonen omdirigerer du ganske enkelt trafikk fra port 443 til Giteas port 3000, og legger til X-Forwarded-For-headerne for å unngå å miste klientens virkelige IP-adresse.

Brukeradministrasjon og kodemigrering

Hvis du har deaktivert åpen logging, kan du opprette den første administratoren ved å bruke kommandolinjen med kommandoen gitea admin user createNår du er inne, kan du legge til din offentlige SSH-nøkler i brukerprofilen for å klone repositorier uten å måtte oppgi passordet hver gang. Hvis du allerede har kode på GitHub, har Gitea en integrert migreringsverktøy Den importerer automatisk ikke bare koden, men også problemene og taggene.

  Slik automatiserer du arbeidsflyter med n8n og Docker

Vedlikehold og tuning

Det er utrolig enkelt å vedlikeholde Gitea. For å oppdatere, last ned den nye binærfilen, erstatt den gamle og start tjenesten på nytt. For sikkerhetskopier, bruk kommandoen gitea dump er din beste venn, siden den genererer en komprimert fil med altDatabase, konfigurasjon og repositorier. For e-post kan du konfigurere en ekstern SMTP-server (for eksempel Gmail) eller installere Postfix på serveren for å motta varsler om pull-forespørsler og varsler.

Implementering av Gitea gir deg en robust, lett og fullstendig privat versjonskontrollplattform, som eliminerer avhengigheten av eksterne tjenester gjennom en binærbasert installasjon, en optimalisert database og en omvendt proxy som garanterer trafiksikkerhet via HTTPS.