1. 1 · Preparare il computer
2. 2 · Collegarsi al computer
3. 3 · Preparare la rete
4. 4 · Installare BiblioViva
5. 5 · Primo avvio
6. 6 · Collegare i dispositivi
7. 7 · Provare il lettore e la stampante
8. 8 · Copie di sicurezza

Procedura

La configurazione guidata ha otto passi, indicati in alto come «Passo 1 di 8». In ogni passo il pulsante Avanti resta spento finché i dati richiesti non sono validi; il pulsante Indietro riporta al passo precedente senza perdere quanto già scritto. Quasi tutte le scelte si cambiano più tardi da Amministrazione: le scelte incerte si lasciano come BiblioViva le propone.

Aprire l'indirizzo

L'indirizzo di BiblioViva si apre soltanto da un dispositivo con Tailscale acceso e collegato all'account della scuola. Per il primo avvio basta un solo computer: quello da cui si apre il browser, di norma il computer del banco prestiti. Gli altri dispositivi si aggiungono al passo Collegare i dispositivi.

1. Se Tailscale non è ancora installato su questo computer, installarlo e accedere con l'account della scuola, come descritto nella sezione Installare Tailscale del passo Collegare i dispositivi.
2. Aprire nel browser l'indirizzo stampato da setup.sh, nella forma https://biblioviva.<tailnet>.ts.net.
3. Attendere. Alla prima apertura il certificato HTTPS viene preparato e la pagina può impiegare alcuni secondi.

La pagina Prima configurazione si apre sul primo passo. La configurazione guidata compare soltanto finché non è completata e non chiede alcuna password: completarla subito, senza lasciare la pagina aperta e incustodita.

Lingua

La prima schermata può comparire in inglese. BiblioViva parla una sola lingua per installazione, valida per tutto il personale.

1. Scegliere «Italiano». La configurazione guidata passa subito in italiano.
2. Premere Avanti.

La lingua si cambia anche dopo, da Amministrazione → Configurazione → Aspetto e lingua.

Chi sposta BiblioViva su un altro computer, o ricomincia dopo un guasto, non risponde alle domande della configurazione guidata: sotto la scelta della lingua preme Ripristina da un backup e sceglie l'archivio fatto con Esporta tutto. La procedura è nella sezione Dal primo avvio di Ripartire da una copia di sicurezza.

Colori

BiblioViva offre quindici set di colori. Cambiano solo i colori, mai la forma, e restano leggibili anche in bianco e nero.

1. Scegliere un set di colori. L'anteprima si vede subito sulla pagina. Il set proposto è Oceano.
2. Premere Avanti.

Anche i colori si cambiano dopo, da Amministrazione → Configurazione → Aspetto e lingua.

Biblioteca

1. Scrivere nel campo Nome della biblioteca il nome che deve comparire in alto a sinistra, sulle tessere e sulle stampe, per esempio il nome della scuola preceduto da «Biblioteca». Il campo è obbligatorio.
2. Lasciare attiva la casella Foto degli utenti se le tessere devono portare la foto di studenti e docenti. Togliere la spunta se la scuola preferisce non conservare foto: allora non c'è alcuna foto in nessuna pagina e le tessere escono senza foto.
3. Lasciare attiva la casella Copertine dei libri se il catalogo deve mostrare le copertine, cercate in rete, fotografate o caricate. Togliere la spunta per non avere alcuna copertina.
4. Premere Avanti.

Le due caselle si cambiano dopo da Amministrazione → Configurazione → Foto degli utenti e da Amministrazione → Configurazione → Copertine; spegnerle non cancella nulla di quanto è già salvato.

Scuola

Il tipo di scuola propone gli anni, le classi e i livelli di lettura. Le classi si creano subito.

1. Scegliere nell'elenco Tipo di scuola quello della propria scuola, cercandolo sotto «Italia». Se la scuola riunisce più ordini, scegliere l'istituto comprensivo. Il tipo proposto è la scuola primaria.
2. Controllare i nomi delle classi. Per ogni ordine di scuola compare un campo (per esempio «Primaria: nomi delle classi, uno per anno») con i nomi delle sezioni, separati da virgole: A-D vale A, B, C, D. I nomi si ripetono per ogni anno. Un campo vuoto non crea classi.
3. Controllare l'elenco delle classi che verranno create, sotto i campi.
4. Lasciare la scelta di Come si scrive la classe com'è, salvo che la scuola scriva le classi in altro modo. Le voci mostrano un esempio, come «1 B».
5. Controllare il campo Gruppo dei docenti: i docenti entrano in questo gruppo e altri gruppi si aggiungono dopo.
6. Controllare Inizio dell'anno scolastico, scritto come mese e giorno nella forma MM-GG, per esempio 09-01.
7. Scegliere in Nome dell'anno scolastico se l'anno si scrive con due anni, come «2026/2027», o con l'anno di inizio, come «2026». In Italia si usano due anni.
8. Lasciare attiva la casella Libri di narrativa divisi per livello di lettura se la biblioteca ordina i romanzi per livello. Sotto la casella compaiono i livelli che verranno creati.
9. Premere Avanti.

Anni, classi e livelli di lettura si cambiano dopo da Amministrazione → Configurazione → Scuola e da Amministrazione → Configurazione → Classi.

Codici

Il passo Codici fissa il formato dei codici a barre delle nuove copie e quello delle nuove tessere, scelti ciascuno per conto suo. I due formati non si possono confondere: chi legge un codice capisce subito se è un libro o una tessera.

1. Lasciare in Formato delle copie la voce proposta, «Anno, controllo e numero (consigliato)», oppure sceglierne un'altra.
2. Lasciare in Formato delle tessere la voce proposta, «Controllo e numero di 6 cifre (consigliato)», oppure sceglierne un'altra.
3. Lasciare in Carattere di controllo la voce proposta, «Una lettera (mod 23)».
4. Controllare Tastiera dei lettori: deve essere la lingua della tastiera del computer a cui si collega il lettore di codici a barre. In italiano è «Italiana». Il valore serve a correggere i caratteri che un lettore impostato per un'altra tastiera scrive male; il passo Provare il lettore e la stampante lo verifica.
5. Controllare gli esempi sotto i campi, per la Copia di un libro e per la Tessera.
6. Verificare che compaia il messaggio «Copie e tessere non si possono confondere.» Se compare invece un avviso di rifiuto, scegliere un altro formato.
7. Premere Avanti.

I formati, i codici di sistemi precedenti e la numerazione si cambiano dopo da Amministrazione → Configurazione → Codici a barre. Una biblioteca che ha già libri e tessere con codici stampati da un altro sistema lascia qui le scelte proposte: i codici esistenti si aggiungono in seguito, e continuano a funzionare.

Dati di prova

I dati dimostrativi sono studenti, libri e prestiti inventati, generati secondo la scuola e i codici scelti: servono a provare BiblioViva prima di inserire i dati veri. Non corrispondono ad alcuna persona reale.

1. Per provare BiblioViva prima dell'uso vero, attivare la casella Carica dati dimostrativi. Per iniziare subito con i dati veri, lasciarla spenta.
2. Premere Avanti.

Con i dati dimostrativi tutti gli account usano la stessa password, semplice da ricordare. I dati dimostrativi si tolgono quando si è pronti, con un solo pulsante:

1. Accedere come admin e aprire Amministrazione.
2. Premere Svuota dati dimostrativi e confermare.

La cancellazione svuota il database e le foto e disconnette tutti gli operatori; la configurazione e gli account restano. Dopo la cancellazione cambiare subito le password da Amministrazione → Account del personale, perché quelle dei dati dimostrativi sono note a tutti.

Se il database contiene già dei dati, il passo lo segnala e i dati dimostrativi non vengono caricati.

Password

BiblioViva ha cinque account condivisi, uno per ruolo. Ciascuno entra con il proprio nome utente e la propria password.

1. Leggere le password proposte: sono generate a caso e vanno bene così. Per cambiarne una, scriverne un'altra nel campo, di almeno 8 caratteri.
2. Per avere un'altra password casuale, premere il pulsante Rigenera accanto al campo.
3. Premere Avanti.

Con i dati dimostrativi attivi i campi non si modificano: tutti gli account usano la password biblioviva.

Riepilogo

1. Controllare il riepilogo: lingua, colori, biblioteca, classi, codici e dati di prova.
2. Copiare le password di tutti gli account, per esempio su un foglio di carta tenuto al sicuro.
3. Premere Completa la configurazione. Durante il salvataggio il pulsante mostra «Salvataggio in corso…».

Se compare un messaggio di errore, rileggere i passi con Indietro e riprovare. Dopo il salvataggio compare la schermata Configurazione completata.

Configurazione completata

1. Controllare che le password annotate coincidano con quelle mostrate. Se i dati dimostrativi sono stati caricati, compare anche il numero di utenti, titoli, copie e prestiti creati.
2. Premere Vai all'accesso.
3. Scrivere admin nel campo Nome utente.
4. Scrivere la password dell'account admin nel campo Password.
5. Premere Entra.

Possibili problemi

• La pagina non si apre con Tailscale: il computer non ha Tailscale acceso e collegato all'account della scuola, oppure la funzione dei nomi (MagicDNS) o dei certificati HTTPS non è attiva nella console di Tailscale. Il passo Preparare la rete descrive entrambi i controlli.
• La pagina non si apre con la rete locale: il computer non è sulla stessa rete di BiblioViva, oppure il nome biblioviva.local non è riconosciuto. Usare l'indirizzo numerico del computer, come indicato sopra.
• Una password è stata persa: le password non si rivedono. Entrando con admin, le altre si cambiano da Amministrazione → Account del personale. Per la password di admin serve la procedura tecnica «Forgotten admin password» della pagina Deployment notes (technical) (in inglese).
• Il pulsante Avanti non si accende: un campo del passo è vuoto o non valido. Il campo da correggere mostra un avviso: per esempio la password di almeno 8 caratteri o l'inizio dell'anno nella forma MM-GG.

Pagine correlate

• Passo precedente: Installare BiblioViva
• Passo successivo: Collegare i dispositivi
• Problemi comuni