...

web/INSTALL

@@ -1,22 +0,0 @@
-- Le istruzioni in questo paragrafo riguardano un'installazione sotto
-  apache; sotto nginx o altri webserver dovrebbe trattarsi di adeguarle.
-  Se hai installato mastostart nella DocumentRoot di apache o di un
-  virtualhost definito in apache bona lè, sei già a posto; se invece l'hai
-  installato in una sottodirectory della DocumentRoot (per esempio
-  «[DocumentRoot]/mastostart») imposta al percorso della sottodirectory
-  la variabile «instpath» in «mastostart.ini» (per esempio
-  «instpath="/mastostart"») e la direttiva «RewriteBase» in «.htaccess»
-  (per esempio «RewriteBase "/mastostart").
-
-- Per quanto riguarda l'installazione di Mustard, importa in mariadb o mysql
-  il dump sql «mastostart_struttura_e_dati_pro_installazione.sql.gz»
-  che trovi nella directory «mustard/zzz-materiali/».
-  Edita il file di configurazione commentato «mustard/sec/mustard.ini».
-  Crea un “superadmin” per poter entrare in mustard lanciando
-  «php addsuperadmin.php» dalla directory «mustard/tools/».
-
-- Per quanto riguarda il crawler che crea/aggiorna i dati relativi alle
-  istanze nel database, si tratta di farne girare i due componenti
-  uno dopo l'altro, la prima volta magari da shell, poi con un cron job
-  (quotidiano? settimanale?). Per farlo è sufficiente lanciare lo script
-  «crawl.sh» che si trova nella directory «mustard/crawler».

web/INSTALL.md

@@ -0,0 +1,11 @@
+* Requisiti: apache (o altro web server, ma per ora le istruzioni qui sono per apache) con mod_rewrite abilitato; php7 (cli e "per apache") con estensioni mysqli, mb_string, pcntl; mariadb (dovrebbe funzionare anche con mysql, ma non l'ho testato).
+
+* Php dovrebbe essere configurato con un limite di memoria (memory_limit) usabile abbastanza alto, serve per il crawler che mappa ricorsivamente un bel po' di istanze, al momento circa 16.000, delle quali però al momento solo circa 3.000 finiscono nel database (per tantissime istanze l'endpoint \[dominio\]/api/v1/instance poi non risponde, o perché l'istanza è morta, o perché non si tratta di istanza mastodon, o perché l'endpoint è disabilitato, o per varie ed eventuali). Devo ancora testare quanta memoria effettivamente prende il crawler quando gira, per ora quel che so è che con 128 mb (il default sotto arch linux) non ce la fa, mentre con 8 gb (memory_limit=8G) si :)) ... ma è probabile che gli serva molto meno.
+
+* Se si vuole provare la funzione di invio delle mail di invito agli admin delle istanze, php deve essere configurato in modo che sia in grado di inviare mail dall'indirizzo email "mittente" definibile impostando la variabile «ref_email» in «mustard/sec/mustard.ini». Inoltre: per favore, sempre in «mustard/sec/mustard.ini», cambia il valore della variabile «mail_test_address» (attualmente impostato a un indirizzo email mio), impostando un tuo indirizzo email valido (presso cui sarai tu a ricevere le mail di invito, invece delle admin delle istanze) e NON impostarla a stringa vuota o a false, in modo da NON inviare inviti reali (il tutto è spiegato, spero meglio, nei commenti in «mustard/sec/mustard.ini»).
+
+* Le istruzioni in questo paragrafo riguardano un'installazione sotto apache; sotto nginx o altri webserver dovrebbe trattarsi di adeguarle. Se hai installato mastostart nella DocumentRoot di apache o di un virtualhost definito in apache bona lè, sei già a posto; se invece l'hai installato in una sottodirectory della DocumentRoot (per esempio «\[DocumentRoot\]/mastostart»), imposta al percorso della sottodirectory la variabile «instpath» in «mastostart.ini» (per esempio «instpath="/mastostart"») e la direttiva «RewriteBase» in «.htaccess» (per esempio «RewriteBase "/mastostart").
+
+* Per quanto riguarda l'installazione di Mustard, importa in mariadb o mysql il dump sql «mastostart_struttura_e_dati_pro_installazione.sql.gz» che trovi nella directory «mustard/zzz-materiali/». Edita il file di configurazione commentato «mustard/sec/mustard.ini». Crea un “superadmin” per poter entrare in mustard lanciando «php addsuperadmin.php» dalla directory «mustard/tools/».
+
+* Per quanto riguarda il crawler che crea/aggiorna i dati relativi alle istanze nel database, si tratta di farne girare i due componenti uno dopo l'altro, la prima volta magari da shell, poi con un cron job (quotidiano? settimanale?). Per farlo è sufficiente lanciare lo script «crawl.sh» che si trova nella directory «mustard/crawler».

web/mustard/dafa.txt

@@ -4,6 +4,14 @@
 * fatto
 # in corso
 
+[immagine docker]
+- istruzioni per usarla
+- cron e cron job per il crawler
+- /usr/local/bin/binit dovrebbe lanciare mysql con file di log ecc. più umani
+- niente virtualhost, spostare mastostart nella docroot di default di apache, così che per vederlo basti andare su 172.17.0.2, senza dover toccare /etc/hosts
+
+- vedere un po' se è possibile determinare quanta ram sugge il crawler, in modo da poter dare indicazioni più precise in INSTALL
+- nei template per le mail dichiarare che un requisito è moderazione attiva contro contenuti fascisti-razzisti-sessisti
 - crawler.php: possibilità di passargli le opzioni da riga di comando
 * viewinst.php
 - pagina gestione accounts

web/mustard/sec/mustard.ini

@@ -5,13 +5,19 @@ db_name=mastostart
 db_admin_name=MastoStartAdmin
 db_admin_password=MastoStartAdmin
 ;; questo qui sotto è il nome di riferimento di mastostart, al momento
-;; viene usato solo nell'invio delle mail di invito
+;; viene usato solo nell'invio delle mail di invito, come mittente, insieme
+;; a "ref_email" (vedi più sotto).
 ref_name=Mastodon Startpage
 ;; questo qui sotto è l'indirizzo email di contatto di mastostart,
-;; al momento viene usato solo nell'invio delle mail di invito
+;; al momento viene usato solo come mittente nell'invio delle mail
+;; di invito; se vuoi testare questa funzione, per favore impostalo
+;; a un tuo indirizzo e leggi con attenzione tutto il resto di questo
+;; amabile file di configurazione.
 ref_email=qodobop@inventati.org
 ;; questo qui sotto è il dominio di riferimento di mastostart, al momento
-;; viene usato solo nell'invio delle mail di invito
+;; viene usato solo nell'invio delle mail di invito per costruire la url
+;; per il login a mustard da passare alle admin delle istanze invitate
+;; ("https://[site_domain]/mustard")
 site_domain=mastodon.help
 ;; questo qui sotto funziona così: se lasciato vuoto o impostato a "false"
 ;; o a "no", le mail di invito verranno effettivamente inviate all'indirizzo
@@ -19,6 +25,8 @@ site_domain=mastodon.help
 ;; inviate invece all'indirizzo specificato qui e non verrà apportata
 ;; alcuna modifica al database (niente creazione account "guest", niente
 ;; associazione dell'istanza all'account creato).
-;; può essere utile impostarlo a un proprio indirizzo mail per testare
-;; che il sistema di invio posta funzioni, eventualmente.
+;; Per favore, se vuoi testare la funzione di invio email di invito,
+;; imposta questa variabile a un tuo indirizzo email valido, e in ogni caso
+;; NON lasciarla vuota, NON impostarla a "false" o a "no": non mandare
+;; in giro mail di invito ad minchiam ;-)
 mail_test_address=pezcurrel@tiscali.it