Forgejo con Docker: Git self-hosted senza fronzoli

Unknown — Fri, 11 Jul 2025 00:00:00 +0000

Da tempo utilizzo Git per gestire i miei progetti personali, sia software che di configurazione. Per anni mi sono affidato al pc di qualcunaltro (es: Gitlab o GitHub), ma la dipendenza da un servizio centralizzato, per quanto comodo, inizia a starmi stretta. Così ho cercato una soluzione più allineata alla mia filosofia: Forgejo, un fork comunitario di Gitea, leggero e facilmente self-hostabile.

services: forgejo: image: codeberg.org/forgejo/forgejo:latest container_name: forgejo restart: always environment: - USER_UID=1000 - USER_GID=1000 volumes: - ./data:/data - /etc/timezone:/etc/timezone:ro - /etc/localtime:/etc/localtime:ro - ./robots.txt:/data/gitea/public/robots.txt:ro expose: - "3000" networks: - forgejo_net networks: forgejo_net: driver: bridge </code></pre>

/etc/nginx/sites-available/forgejo.conf
</span>
</span>server {
</span>    listen 80;
</span>    server_name git.miodominio.it;
</span>
</span>    return 301 https://$host$request_uri;
</span>}
</span>
</span>server {
</span>    listen 443 ssl;
</span>    server_name git.miodominio.it;
</span>
</span>    ssl_certificate /etc/letsencrypt/live/git.miodominio.it/fullchain.pem;
</span>    ssl_certificate_key /etc/letsencrypt/live/git.miodominio.it/privkey.pem;
</span>
</span>    location / {
</span>        proxy_pass http://localhost:3000;
</span>        proxy_set_header Host $host;
</span>        proxy_set_header X-Real-IP $remote_addr;
</span>        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
</span>        proxy_set_header X-Forwarded-Proto $scheme;
</span>    }
</span>}
</span></code></pre>
Dopo aver creato il file, attivare con:</p>
ln</span></span> -</span>s</span> /etc/nginx/sites-available/forgejo.conf /etc/nginx/sites-enabled/</span>
</span>nginx</span></span> -</span>t</span></span> &&</span> systemctl</span></span> reload nginx</span>
</span></code></pre>

</span></a>
Backup automatico</h2>
Il backup rappresenta un step fondamentale del nostro setup, conviene implementarne subito uno all'avvio del servizio, cosi non ce ne dimenticvheremo e terremo i nostri dati al sicuro. Ricordiamoci che qui salveremo il risultato di diverse ore di programmazione, studio e prove!</p>
I nostri dati si trovano nel volume data di cui sopra, quindi sarà sufficiente salvare il docker file e la directory data.
Io consiglio di usare #borg ma potete usare il softwsre che preferite, trovo particolarmente utile aggiungere questa nuova directory alle procedure di salvataggio che sicuremante avrete già per tutto il resto.
(se non le avete potete anche smettere di leggere questo blog, tornate quando ne avrete implementata una).</p>

</span></a>
Configurazioni iniziali</h2>
A questo punto, dopo l'installazione, non ci resta che accedere via web al nostro software e fare le prime configurazioni.
È possibile creare utenti, organizzazioni, concedere permessi e creare tutti i repository che si desiderano.</p>
Ciascun progetto può essere impostato ad accesso privatp</em> o pubblico</em>.</p>
In questo modo sarà semplicissimo collaborare in più persone allo stesso progetto, tenendo traccia delle varie modifiche.</p>
Infine è anche possibile importare direttamente altri repository git.</p>
</span></a>
Runner e Action</h2>
Forgejo, essendo un fork di Gitea, supporta un sistema di CI/CD</em> integrato chiamato Actions, simile a GitHub Actions, e permette di eseguire job di build o deploy tramite runner personalizzati.</p>
Io stesso ne faccio uso, è uno dei motivi per cui mi sto trovando benissimo con forgejo! Ho varie configurazione a seconda del progetto ospitato, ma essenzialmente queste si occupano di effettuare il "deploy" del codice, cioé copiano a destinazione (server di sviluppo o di produzione a seconda dei casi), il codice modificato, cosi che sia pronto all'uso.
In questo modo, grazie alla history di git, sarà sempre possibile tornare indietro, nonché tenere traccia delle modifiche nel tempo.</p>
</span></a>
Come funziona</h3>
Le Actions sono definite da file YAML nei repository (.forgejo/workflows/), e possono contenere job con step eseguiti su runner registrati.</p>
I runner sono agent installati su macchine (stessa VPS o remote), che si collegano al server Forgejo e attendono job da eseguire.</p>
Una volta definita la condizione scatenante (es: commit su ramo main, rilascio di una nuova versione, ecc) partirà il worksflow che abbiamo definito, con la possibilità di verificarne lo stato di esecuzione in tempo reale. Infine è anche possibile andare a vedere i log delle esecuzione precedenti.</p>
All'interno di una action si possono usare #secret e #variabili, in modo da poter riusare il codice della action e allo stesso tempo mantenere al sicuro le credenziali.</p>
</span></a>
Setup runner base</h3>
Vediamo come creare un nuovo runner, passo passo:</p>
export</span> RUNNER_VERSION</span>=</span>$</span>(</span>curl</span></span> -</span>X</span> '</span>GET'</span></span> https://data.forgejo.org/api/v1/repos/forgejo/runner/releases/latest</span> |</span> jq</span></span> .name -</span>r</span></span> |</span> cut</span></span> -</span>c</span> 2-</span>)</span></span></span></span>
</span>wget</span></span> -</span>O</span> forgejo-runner https://code.forgejo.org/forgejo/runner/releases/download/v$</span>{</span></span>RUNNER_VERSION</span></span>}</span></span>/forgejo-runner-$</span>{</span></span>RUNNER_VERSION</span></span>}</span></span>-linux-amd64</span>
</span>chmod</span></span> +x forgejo-runner</span>
</span>sudo</span></span> mv forgejo-runner /usr/local/bin/forgejo-runner</span>
</span>sudo</span></span> useradd -</span>m</span> -</span>s</span> /bin/bash forgejo-runner</span>
</span>sudo</span></span> usermod -</span>aG</span> docker forgejo-runner</span>
</span></code></pre>
Rechiamoci sull'interfaccia web di Forgejo:
Forgejo > Repository > Settings > Actions > Runners > "Generate new token"</em></p>
sudo</span></span> -</span>i</span> -</span>u</span> forgejo-runner</span>
</span>forgejo-runner</span></span> register</span>
</span></code></pre>
</span></a>
Avvio automatico del runner</h4>
Io ho usato uno script systemd per l'avvio automatico, ve lo riporto di seguito</p>
sudo</span></span> echo "</span>
</span></span></span>[Unit]
</span></span></span>Description=Forgejo Act Runner
</span></span></span>After=network.target docker.service
</span></span></span>Requires=docker.service
</span></span></span>
</span></span></span>[Service]
</span></span></span>User=forgejo-runner
</span></span></span>Group=forgejo-runner
</span></span></span>ExecStart=/usr/local/bin/forgejo-runner daemon
</span></span></span>Restart=always
</span></span></span>WorkingDirectory=/home/forgejo-runner
</span></span></span>
</span></span></span>[Install]
</span></span></span>WantedBy=multi-user.target"</span></span> ></span> /etc/systemd/system/forgejo-runner.service</span>
</span>
</span>sudo</span></span> systemctl daemon-reload</span>
</span>sudo</span></span> systemctl enable forgejo-runner</span>
</span>sudo</span></span> systemctl start forgejo-runner</span>
</span>systemctl</span></span> status forgejo-runner</span>
</span></code></pre>

</span></a>
Vantaggi in breve</h2>

Repository del proprio codice, diviso come si preferisce: singoli progetti, organizzazioni, ecc.</li>
Possibilità di creare utenti per collaboratori/amici con controllo sugli accessi/permessi.</li>
Automatizzo test, build, deploy senza dipendere da servizi esterni.</li>
Nessuna dipendenza da fornitori terzi e nessun limite di spazio, esecuzioni, personalizzazioni.</li>
Versionamento del codice, e nel caso di ci/cd garanzia di riproducibilità</li>
Pocchissime risorse necessarie lato server</li>
Vuoi mettere quanto è figo avere il proprio servizio di versionamento?</li>
</ul>
</span></a>
Uso quotidiano</h2>
Forgejo supporta #git via #ssh, Web UI e #webhooks. Ho configurato alcuni repository con CI locale usando le Actions e i runner integrati. L’interfaccia è leggera e pulita, senza funzionalità inutili.</p>
</span></a>
Conclusioni</h2>
Forgejo è una soluzione Git solida, coerente con un approccio decentralizzato. Semplice da gestire, veloce da installare, e adatta anche per chi – come me – preferisce sapere dove stanno i propri dati. Per ora lo utilizzo solo per progetti personali, ma potrei iniziare a usarlo anche per collaborazioni future.</p>
Non vi resta che provarlo, fatemi sapere le vostre impressioni con un commento nel #fediverso su questo articolo.</p>

Nextcloud

Unknown — Fri, 23 Feb 2024 00:00:00 +0000

Nota Introduttiva: questo articolo sarà solo un'introduzione, seguiranno approfondimenti sui singoli componenti.

</a> Cos'è nextcloud</h2>
Software open source che permette di realizzare un servizio Cloud personale per i propri dati. Ambiente collaborativo e può anche essere federato con altre installazioni. È possibile installarlo su un proprio dispositivo o usare quello messo a disposizione da alcune aziende o associazioni. L'architettura è modulare, questo ci permette di attivare solo le funzionalità che ci servono e se ne possono aggiungere di nuove (via via che gli sviluppatori le rilasciano). C'è un plugin per ogni esigenza!

</a> Caratteristiche</h2>
Il suo punto di forza è la condivisione e la sincronizzazione dei file, che può avvenire tramite semplice browser web o utilizzando l'applicazione disponibile per tutti i sistemi operativi. Possiamo considerarlo un'alternativa a Dropbox, Google drive o onedrive. Ci sono anche numerosi servizi aggiuntivi, che coprono diverse esigenze, come ad esenpio:

calendario</li>
contatti</li>
webmail</li>
attività (task)</li>
note (markup language)</li>
chat interna</li>
suite per l'ufficio (via web, basata su libreoffice)</li>
galleria immagini</li>
ebook reader</li>
password manager</li>
gestione bookmark (con possibilità di sync con plugin per il browser)</li>
podcast</li>
libro di ricette</li>
ricerca</li>
forms</li> </ul>
Questi servizi possono essere usati via web, o con i vari client, con il vantaggio di avere tutto sincronizzato tra più dispositivi. Nextcloud diventa così il proprio hub personale dove ci sono tutti i propri dati e le proprie attività.


self hosting: possiamo installarlo su un nostro pc o su una #vps in modo che i nostri dati siano sempre sotto il nostro controllo.</li>
nel caso si voglia affidarsi al lavoro di altri, possiamo scegliere il provider che vogliamo e cambiarlo in qualsiasi momento (esportando i dati)</li>
tra utenti dello stesso server (o federati) è possibile collaborare</li>
condivisione di file (e immagini) avendo sempre tutto sotto controllo, vedi paragrafo dedicato sotto.</li>
ricerca globale: usando la casella di ricerca, questa verrà effettuata ovunque: file, note, contatti, calendario, ecc. ecc.</li> </ul>


Database: dipende da quello che avete scelto, ma solitamente si tratta di Mysql (o MariaDB). Le procedure di salvataggio sono quelle consuete (mysqldump), che potete trovare in rete o in questo blog (in futuro).</li>
File: salvataggio della directory nextcloud ospitata dal webserver, che contiene sia il software che i nostri dati</li>
Se non siamo gli unici utilizzatori dell'istanza, è consigliabile impostare l'istanza in modalità manutenzione durante le operazioni di salvataggio, in modo da avere la consistenza dei dati.</li> </ol>
Vi consiglio di usare un sistema come #borg, il quale può essere usato in modalità incrementale così vi garantisce di poter recuperare sempre una certa versione dei vostri documenti e ha il vantaggio che, dopo la prima esecuzione, i backup successivi trasferiranno solo le nuove modifiche sul backup, saranno così molto veloci e occuperanno solo lo spazio strettamente necessario!

cartelle (e file) in sola lettura per utenti anonimi anche protetti da password</li>
possibilità di poter ricevere file da altri (upload)</li>
galleria foto</li>
cartelle collaborative con altri utenti del server (o istanze federate)</li>
supporto nativo a #webdav</li>
applicazione desktop per sincronizzazione automatica dei file.</li>
supporto al versionamento</li> </ul>
configurando un app come #davx5 vi permette di sincronizzare contatti e calendario del vostro smartphone</li>
È possibile sincronizzare anche i client desktop, sfruttando i protocolli standard #caldav e #carddav</li>
import e export da e verso altri sistemi</li> </ul>

accesso a tutti i propri file in mobilità</li>
auto upload delle foto scattate</li> </ul>

gestione categorie</li>
sotto task</li>
date di inizio e scadenza</li>
percentuale avanzamento</li> </ul>

accesso web</li>
markup language</li>
categorie</li>
app mobile</li> </ul>

Software basato sul diffuso libreoffice</li>
Editing collaborativo real time (è necessario installare Collabora office)</li> </ul>

accesso web</li>
markup language</li>
categorie</li>
app mobile</li> </ul>

Software basato sul diffuso libreoffice</li>
Editing collaborativo real time (è necessario installare Collabora office</strong>)</li> </ul>

Software basato sul diffuso libreoffice</li>
Editing collaborativo real time (è necessario installare Collabora office</strong>)</li> </ul>

Software basato sul diffuso libreoffice</li>
Editing collaborativo real time (è necessario installare Collabora office</strong>)</li> </ul>

~/magostinelli - selfhost

Forgejo con Docker: Git self-hosted senza fronzoli

Nextcloud