Servidores CaserosTécnico

Servidor Git propio con Gitea

Guarda tu código, configuraciones y archivos de proyectos en repositorios privados en tu propio Pi, con interfaz web, issues y pull requests.

NivelTécnico
Tiempo1 h
Costo est.~$157
Pasos5

Gitea es un servicio Git liviano y de código abierto con una interfaz web conocida. Es perfecto para respaldar tus configuraciones de ESPHome, el YAML de Home Assistant y el código del Pico con todo su historial.

Pasos de la misión

  1. Inicia Gitea

    Guarda el archivo compose de abajo y ejecuta docker compose up -d. Usa un SSD o disco USB para la carpeta de datos en lugar de la microSD.

  2. Termina el instalador

    Abre el puerto 3000, deja SQLite para un servidor casero pequeño, pon la IP del Pi como dominio del servidor y crea la cuenta de administrador.

  3. Agrega tu llave SSH

    Pega la llave pública de tu laptop en la configuración de tu usuario. Clona por SSH en el puerto 2222.

  4. Sube un proyecto

    Crea un repositorio en la interfaz web y sube una carpeta existente con git remote add y git push.

  5. Copia repos importantes

    Usa 'Nueva migración' para mantener una copia espejo de proyectos públicos de los que dependes.

Código

services:
  gitea:
    image: gitea/gitea:latest
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: unless-stopped
    volumes:
      - /mnt/ssd/gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"
      - "2222:22"

Code comments are in English, like most libraries and docs — a good habit for makers.

Preguntas

¿Puede correr CI como GitHub Actions?

Sí. Activa Gitea Actions y registra un act_runner; muchos flujos de GitHub Actions corren con pocos cambios o ninguno.

¿Gitea o Forgejo?

Forgejo es un fork comunitario de Gitea y se instala casi igual. Cualquiera sirve para un servidor casero.