Salta ai contenuti
Octoboard Documentazione

Server Linux

Installa octoboardd, il programma server di Octoboard (l’app lo chiama il servizio), su un server Linux senza privilegi di root. Raggiungilo dall’app per macOS o Windows, o da un browser, in entrambi i casi tramite SSH.

Per x86_64 e aarch64, su qualsiasi distribuzione.

  • Un server Linux a cui puoi accedere con SSH. SSH è un modo sicuro per accedere a un’altra macchina e digitarvi comandi. Il provider del server ti dà il suo indirizzo e il tuo nome utente.
  • L’app Octoboard sul tuo computer, per macOS o Windows, se vuoi lavorare nell’app desktop (consigliato).

Per accedere, apri Terminale (macOS) o PowerShell (Windows) sul tuo computer ed esegui il comando qui sotto, con il tuo nome utente al posto di <you> e l’indirizzo del server al posto di <server>. La prima volta, rispondi yes quando ti chiede se considerare attendibile il server.

Terminal window
ssh <you>@<server>

I passaggi 1 e 2 qui sotto si eseguono sul server, in quella finestra in cui hai effettuato l’accesso.

  1. Installa octoboardd sul server.

    Terminal window
    curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh

    Stampa una riga che inizia con Installed octoboardd.

  2. Avvialo sul server.

    Terminal window
    octoboardd start

    Stampa una riga che inizia con Octoboard started.

  3. Collegati dal tuo computer, in uno di due modi:

    • Dall’app desktop (consigliato): segui Connettiti a un server Linux nella guida SSH.

    • Da un browser: esegui questo sul server.

      Terminal window
      octoboardd address

      Stampa due cose: un indirizzo del browser, che inizia con http://127.0.0.1:, e un comando ssh. Sul tuo computer, copia il comando ssh, sostituisci <server> con l’indirizzo del server (l’indirizzo IP o il nome che usi per accedervi) ed eseguilo in Terminale o PowerShell. Potrebbe chiederti la password, poi non mostra altro: è normale. Lascia aperta quella finestra: chiuderla interrompe la connessione. Poi apri nel browser l’indirizzo stampato.

Saprai che ha funzionato quando Octoboard si apre nella nuova finestra dell’app desktop o nella scheda del browser.

Se l’installazione dice che una cartella che termina con .local/bin (per esempio /home/<you>/.local/bin) non è nel tuo PATH, la shell non riesce a trovare octoboardd per nome. Eseguilo con il percorso completo che l’installazione ha stampato, oppure aggiungi ~/.local/bin al tuo PATH (per esempio in ~/.profile) e accedi di nuovo.

Tenerlo in esecuzione dopo la disconnessione o il riavvio

Sezione intitolata “Tenerlo in esecuzione dopo la disconnessione o il riavvio”

Se avviato con octoboardd start, octoboardd si ferma quando il server si riavvia e nulla lo riavvia da solo: esegui di nuovo octoboardd start, oppure collegati dall’app desktop, che si offre di avviarlo per te. Alcuni server lo fermano anche quando esci dalla sessione.

Per farlo partire a ogni avvio del server e tenerlo in esecuzione anche dopo che sei uscito, installalo invece come servizio:

Terminal window
curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh -s -- --service

Questo comando installa il programma, lo configura come servizio utente systemd e lo avvia. Poi attiva il lingering, che permette ai tuoi servizi di restare in esecuzione quando non hai effettuato l’accesso. Se dice di non esserci riuscito, esegui questo una sola volta (potrebbe servire sudo):

Terminal window
loginctl enable-linger "$USER"

La porta predefinita è 3369. Per usarne un’altra, aggiungi --port <port> alla fine del comando del servizio, o a octoboardd start.

Octoboard non si aggiorna mai da solo: quando esce una nuova versione, il browser te lo segnala e scegli tu quando installarla. Una volta installata la nuova versione, Octoboard si riavvia da solo con quella quando nessuna sessione verrebbe interrotta; se qualcuna lo fosse, le elenca e chiede prima.

  • Nel browser: seleziona Scarica e installa dove indica che è disponibile una nuova versione.

  • Sul server: esegui questo comando.

    Terminal window
    octoboardd update

    Se chiede se riavviare ora, rispondi y per riavviare, oppure premi Invio per lasciare per ora in esecuzione la vecchia versione. Per riavviare più tardi, esegui octoboardd restart.

Se octoboardd update dice che non riesce a sostituire il programma, per esempio perché è installato in una posizione in cui non puoi scrivere, esegui invece di nuovo il comando di installazione (o quello del servizio). Si riavvia nello stesso modo quando è sicuro farlo; altrimenti ti dice di eseguire octoboardd restart.

Archivio x86_64 Archivio aarch64 Tutte le versioni precedenti