diff --git a/README.md b/README.md index 3eb8181..61ec2ab 100644 --- a/README.md +++ b/README.md @@ -1,31 +1,33 @@ -## Lista +## 📋 Lista
Clicca per visualizzare -* [archive warrior](archivewarrior) - un nodo per aiutare l'[archive team](https://archive.org/) -* [borg](borg) - semplice programma per i backup +* [archive warrior](archivewarrior) - un nodo per aiutare l'[archive team](https://archive.org/) +* [borg](borg) - software per i backup 2.0 * [folding@home](folding@home/) - calcolo distrubuito per la ricerca medica -* [dozzle](dozzle/) - interfaccia web per controllare i log dei container -* [gitea](gitea/) - un'alternativa a github/gitlab locale -* [homer](homer/) - semplice pagina per tutti i servizi che volete +* [dozzle](dozzle/) - interfaccia web per controllare i log dei container +* [gitea](gitea/) - server git con interfaccia web +* [homer](homer/) - semplice pagina per tutti i servizi che avete (e non) * [jellyfin](jellyfin/) - server per la gestione e la transcodifica di musica, film e serie tv -* [komga](komga/) - server per la gestione di manga e comics -* [metube](metube/) - frontend moderno per youtube-dl +* [komga](komga/) - server per la lettura e la gestione di manga e comics +* [metube](metube/) - interfaccia web per youtube-dl * [miniflux](miniflux/) - gestore di feed minimale -* [navidrome](navidrome/) - ascolto e gestione di file musicali (MP3/M4A/etc) -* [podgrab](podgrab/) - server per l'ascolto e gestione di podcast -* [syncthing](syncthing/) - simil-dropbox ma decentralizzato +* [navidrome](navidrome/) - server per l'ascolto e la gestione di file musicali +* [podgrab](podgrab/) - server per l'ascolto e la gestione di podcast +* [syncthing](syncthing/) - dropbox decentralizzato * [tor-socks-proxy](tor-socks-proxy/) - tor proxy server * [transmission](transmission/) - client bittorrent * [unifi-controller](unifi/) - interfaccia web per la gestione dell'hardware ubiquiti * [wger](wger/) - server per la gestione della vostra alimentazione e allenamenti -* [watchotwer](watchtower/) - aggiornamento automatico dei container +* [watchotwer](watchtower/) - aggiorna automaticamente i container

-## Struttura degli esempi -**Prima di procedere con gli esempi è necessario avere conoscenza di base di linux e docker(-compose)/podman**
-Versione minima dei software richiesti: **docker@20.10.0**, **docker-compose@1.29.0**, **podman@v3.0.0**
-È quasi tutto semi-esplicativo e abbastanza dettagliato, nel caso di problemi e/o dubbi non esitate a contattarmi in privato su [telegram](https://t.me/ghostakilla) o aprire una [issue](https://gitea.it/miracle091/MasterpieceDockerCompose/issues/new) +## 📚 Struttura degli esempi +**Prima di iniziare ad usare gli esempi è necessario:** +* **una conoscenza di base di linux/unix e docker(-compose)/podman** +* **versione minima dei software richiesti: `docker@20.10.0`, `docker-compose@1.29.0`, `podman@v3.0.0`** + +Essendo quasi tutto esplicativo e dettagliato non dovrebbero esserci problemi, ma nel caso non esitate ad aprire una [issue](https://gitea.it/miracle091/MasterpieceDockerCompose/issues/new). * **Descrizione** * **Struttura file e cartelle** @@ -35,24 +37,24 @@ Versione minima dei software richiesti: **docker@20.10.0**, **docker-compose@1.2 * **Backup e ripristino** * **Todo** -## Precisazioni ed Extra -### Uso della tag *"latest"* -Quasi tutte le immagini sono senza tag, così che venga usata quella di default `latest`, molti ne [consigliano](https://web.archive.org/web/20210409095327/https://vsupalov.com/docker-latest-tag/) l'uso ma siete comunque liberi di usare una versione specifica dell'immagine, in caso di problemi noti o se notate poca stabilità dell'immagine +## 🧭 Precisazioni ed Extra +### Uso implicito della tag *"latest"* +Buona parte delle immagini sono senza tag, in modo tale che venga usata quella di default `latest`, normalmente [ne è consigliato l'uso](https://web.archive.org/web/20210409095327/https://vsupalov.com/docker-latest-tag/). ### Utilizzo di una rete specifica -Ogni compose prevede l'uso di una rete specifica (attualmente è `custom-bridge`), per una gestione *"interna/esterna"* semplificata e migliore, ma avendo comunque un maggiore controllo anche in caso di accesso esterno della vostra rete locale. +Ogni compose prevede l'uso di una rete specifica (attualmente è `custom-bridge`), per una gestione *"interna<->esterna"* semplificata e migliore, ma avendo comunque un maggiore controllo anche in caso di accesso esterno della vostra rete. --- ### Bind mount Tutti i file e le cartelle sono montati direttamente dall'host nel container:
**Pro:** -- Creare, modificare e salvare, come se fosse una qualsiasi cartella/file +- Creare e/o modificare una cartella/file in modo diretto - Backup e ripristini molto semplici **Contro:** -- Maggiore vulnerabilità dell'host, nel caso di un'attacco mirato (esterno per lo più) -- Obbligo di impostare/controllare i permessi (lettura/scrittura) per le cartelle e/o i file +- Maggiore vulnerabilità dell'host, nel caso di un'attacco mirato (in genere dall'esterno) +- Obbligo di impostare e controllare i permessi (lettura/scrittura) per le cartelle/file --- @@ -61,15 +63,19 @@ Tutti i file e le cartelle sono montati direttamente dall'host nel container:
-[DoTheEvo/selfhosted-apps-docker](https://github.com/DoTheEvo/selfhosted-apps-docker/blob/master/README.md)
-[StarWhiz/docker_deployment_notes](https://github.com/StarWhiz/docker_deployment_notes/blob/master/README.md) \ No newline at end of file +### Risorse usate +Le icone sono basate sui lavori di: [Homer Icons (fork di NX211)](https://github.com/NX211/homer-icons), [css.gg](https://css.gg/) e [Simple Icons](https://simpleicons.org/). + +Progetti che mi hanno ispirato: [DoTheEvo/selfhosted-apps-docker](https://github.com/DoTheEvo/selfhosted-apps-docker/blob/master/README.md) e [StarWhiz/docker_deployment_notes](https://github.com/StarWhiz/docker_deployment_notes/blob/master/README.md). + +--- + +### Donazioni +Se vi piace quello che faccio, potete [offrirmi](https://coindrop.to/miracle091) un ☕. \ No newline at end of file