Quando qualcosa si rompe

I problemi in cui ci si imbatte davvero, nell'ordine in cui di solito capitano. Per ciascuno: cosa vedi, perché, e cosa fare.

La prima cosa da provare, sempre

Se l'installazione si è interrotta, riesegui la stessa riga. Ricorda cosa ha già funzionato e riparte da dove si era fermata. Non pone mai la stessa domanda due volte.

Durante l'installazione

"The name … does not lead anywhere yet"

Perché: il tuo indirizzo (per esempio app.example.com) non è ancora collegato alla tua macchina.

1. Accedi all'azienda da cui hai comprato l'indirizzo.

2. Apri la sua pagina DNS (a volte chiamata Zone o DNS records).

3. Aggiungi un record esattamente con ciò che il messaggio ha stampato:

   Tipo	Nome	Valore
   A	la parola mostrata dal messaggio (@ per l'indirizzo nudo)	i numeri mostrati dal messaggio

4. Salva.

5. Aspetta cinque minuti.

6. Riesegui la stessa riga.

Il campo "Nome" è l'errore più comune

Per example.com, scrivi @ (alcuni siti vogliono il campo vuoto). Per app.example.com, scrivi solo app, non l'indirizzo completo.

"The name … does not lead to this machine"

Perché: l'indirizzo punta altrove: una vecchia macchina, o una pagina di parcheggio dell'azienda che lo ha venduto.

1. Apri la stessa pagina DNS.
2. Elimina ogni altro record A con quel nome.
3. Tieni solo quello con il valore stampato dal messaggio.
4. Aspetta cinque minuti, poi riesegui la stessa riga.

Se lo hai cambiato solo da pochi minuti, rispondi sì quando l'installer offre di aspettare. Controlla ogni 20 secondi per un massimo di 10 minuti.

"The address https://… is not answering yet"

Perché: quasi sempre una di due cose.

• Hai puntato l'indirizzo alla macchina solo da pochi minuti. Aspetta dieci minuti, poi riesegui la stessa riga.
• Il tuo provider ha un proprio firewall davanti alla macchina, ed è chiuso.

Per aprire il firewall del provider:

1. Apri il pannello di controllo del tuo provider.
2. Trova le impostazioni Firewall o Security della macchina.
3. Consenti in ingresso TCP 80 e TCP 443.
4. Riesegui la stessa riga.

"Something on this machine is already answering on port 80 / 443"

Perché: il tuo provider ha installato per te un web server sulla macchina. Occupa il posto che serve a OpenTraderWorld.

Incolla questo, poi riesegui la stessa riga:

systemctl disable --now apache2 nginx caddy 2>/dev/null; true

"This machine has … MB of memory" o "Only … MB of disk space is free"

Perché: la macchina è troppo piccola. OpenTraderWorld richiede circa 2 GB di memoria e 8 GB di disco libero.

1. Presso il tuo provider, ridimensiona la macchina a un piano più grande.
2. Riesegui la stessa riga.

"This installer only knows Ubuntu and Debian"

Perché: la macchina è stata creata con un altro sistema.

1. Presso il tuo provider, reinstalla (o ricostruisci) la macchina con Ubuntu 24.04 o Debian 13.
2. Riesegui la stessa riga.

"This needs the machine's administrator rights"

Perché: hai effettuato l'accesso con un account che non può installare software.

Riesegui la riga con sudo in mezzo, esattamente come mostra il messaggio:

curl -fsSL https://get.opentraderworld.com/configure_install.sh | sudo bash -s -- --domain app.example.com

Dopo l'installazione

La pagina non si apre più

1. Accedi alla tua macchina.

2. Digita:

   otw status

3. Se dice Nothing is running o is not answering, digita:

   otw restart

4. Aspetta un minuto, poi ricarica la pagina.

Non riesco più ad accedere alla macchina stessa

Perché: l'installer ha irrigidito il modo in cui la macchina fa entrare le persone.

• Se hai scelto la chiave: accedi dallo stesso computer che hai usato il giorno dell'installazione. Le password sono rifiutate di proposito.
• Se hai scelto una password: accedi con il nome account mostrato sulla tua scheda, non root. L'accesso diretto come root è rifiutato di proposito.

Hai perso quel computer o quella password? Usa la console (a volte chiamata VNC, rescue o web terminal) nel pannello di controllo del tuo provider. Funziona anche quando la via normale d'accesso è chiusa.

Ho dimenticato la password di OpenTraderWorld

1. Accedi alla tua macchina.

2. Digita (sostituisci admin con il tuo nome di accesso se l'hai cambiato):

   docker exec -it opentraderworld-core-1 /app/otw-core reset-password admin

3. Accedi all'app con la password che stampa. L'app ti chiede di sceglierne una nuova.

Per rivedere il tuo indirizzo e il nome di accesso, digita otw card.

Il browser mostra "Non sicuro" o rifiuta la pagina

• Digita l'indirizzo con https:// davanti.
• Se è iniziato pochi minuti dopo l'installazione, aspetta dieci minuti: il lucchetto è ancora in fase di emissione.
• In un'installazione domestica (non un server in affitto), vedi Risoluzione dei problemi.

La macchina è piena

Perché: i backup notturni e lo storico dei prezzi scaricato occupano spazio nel tempo.

1. Digita otw status per vedere quanto spazio resta.
2. Presso il tuo provider, dai alla macchina un disco più grande.
3. Digita otw restart.

Ancora bloccato?

1. Accedi alla tua macchina.

2. Digita:

   otw report

3. Scrive un file e stampa dove si trova. Il file non contiene password.

4. Apri una issue su GitHub, racconta cosa stavi facendo e allega quel file.