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.
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
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.
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.
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.
Sube un proyecto
Crea un repositorio en la interfaz web y sube una carpeta existente con git remote add y git push.
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.