Prerequisiti¶

Prima di installare Jinbocho in self-hosting, assicurati che il tuo server soddisfi i seguenti requisiti.

Sistema operativo¶

Jinbocho funziona su: - Linux (Ubuntu 22.04 LTS o superiore, Debian 12+) — consigliato per VPS o home server/NAS - macOS (12.0 o superiore, Intel o Apple Silicon) - Windows 11 (WSL2 con Ubuntu 22.04)

Utenti Windows: configurazione WSL2¶

Se sei su Windows, usa Windows Subsystem for Linux 2:

# Installa WSL2 con Ubuntu 22.04
wsl --install -d Ubuntu-22.04

# Nel terminale WSL, verifica che siano disponibili almeno 4 GB di RAM
free -h

Docker & Docker Compose¶

Docker Desktop o Docker Engine v20.10+ con Docker Compose v2.20+

Installazione¶

macOS (Homebrew):

brew install docker docker-compose

Linux (Ubuntu/Debian):

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER
newgrp docker

Verifica:

docker --version      # v20.10.0 o superiore
docker compose version  # v2.20.0 o superiore

Git¶

Necessario per clonare il repository di installazione.

macOS:

brew install git

Linux/WSL2:

sudo apt install git

Verifica:

git --version

Client PostgreSQL (psql)¶

Facoltativo ma consigliato per ispezionare il database.

macOS:

brew install postgresql

Linux/Ubuntu:

sudo apt install postgresql-client

Chiavi API esterne (facoltative)¶

Per la ricerca ISBN avanzata, considera di ottenere:

Google Books API Key¶

Perché: fallback per i metadati ISBN quando Open Library è lento
Costo: livello gratuito (100 richieste/giorno)
Come ottenerla: https://developers.google.com/books/docs/v1/using#APIKey
Quando serve: passala come --google-books-key allo script di installazione, oppure imposta GOOGLE_BOOKS_API_KEY in envs/catalog-service.env

Clona il repository di installazione¶

Il self-hosting richiede un solo repository — contiene i file Docker Compose, i template env e gli script di installazione, e clona il frontend per te:

git clone https://github.com/jinbocho/jinbocho-install-community-v1.git
cd jinbocho-install-community-v1

Script di verifica dei prerequisiti¶

Esegui questo script per verificare che tutti i prerequisiti siano installati:

#!/bin/bash
echo "=== Verifica prerequisiti Jinbocho ==="
echo "OS: $(uname -s)"
echo "Docker: $(docker --version)"
echo "Docker Compose: $(docker compose version)"
echo "Git: $(git --version)"
echo "psql: $(psql --version 2>/dev/null || echo 'Non installato')"
echo "✅ Tutti i prerequisiti sono installati!"

Prossimi passi¶

Una volta verificati tutti i prerequisiti, vai a Deploy in Produzione per installare Jinbocho.