Vai al contenuto principale
Home/Docs/Esegui 24/7 su un VPS

☁️ Esegui 24/7 su un VPS

Un piccolo server cloud così il team lavora mentre dormi

Il PC locale è il modo completo più semplice per iniziare. Scegli un VPS se vuoi che il team continui quando quel PC è spento: costa circa €6–10/mese oltre al provider AI e sei tu ad amministrare server, accesso SSH, Docker, rete e spazio di archiviazione.
Validato end-to-end su un Hetzner CPX22 (4 GB RAM / 2 vCPU / 80 GB SSD, ~€9,75/mese). Qualsiasi provider con una macchina Ubuntu 24.04 da 4 GB di RAM funziona allo stesso modo.

⚡ Tutto, in breve

Dal provisioning ai primi annunci con punteggio passano circa 15–30 minuti, per lo più la configurazione della chiave SSH. La sequenza completa sul server:

# After you SSH into the VPS as root:
curl -fsSL https://jobhunterteam.ai/install.sh | bash   # ~1 min
exec bash -l                                            # pick up the jht PATH
jht up                                                  # pull image + start
jht setup                                               # wizard: provider + login
jht providers update                                    # install the provider CLI
jht oauth-login                                         # provider OAuth device flow
jht cloud login                                         # optional: copy results to your web account
jht team start                                          # start the agents
jht team status                                         # verify

🪜 Passo dopo passo

1. Crea il server

Nella console cloud (es. Hetzner), crea una macchina Ubuntu 24.04 , ~4 GB di RAM, in una regione UE per il GDPR. Carica una chiave SSH dedicata — non riutilizzare quella personale:

ssh-keygen -t ed25519 -f ~/.ssh/jht_hetzner -C "jht-vps"
cat ~/.ssh/jht_hetzner.pub   # paste this into the cloud console

Annota l'indirizzo IPv4 del server quando è pronto.

2. Connettiti via SSH

ssh -i ~/.ssh/jht_hetzner root@<VPS_IP>

Suggerimento: prima della prima connessione, confronta il fingerprint dell'host mostrato nella console con ssh-keyscan per escludere un attacco man-in-the-middle.

3. Aggiungi un po' di swap (consigliato)

Otto agenti possono far impennare la RAM. 2 GB di swap preventivo evitano un OOM kill:

fallocate -l 2G /swapfile && chmod 600 /swapfile
mkswap /swapfile && swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

4. Installa, configura, avvia

Esegui la one-liner e i comandi della versione breve qui sopra. Due cose contano in particolare su un VPS:

  • jht cloud login — collega facoltativamente il server al tuo account web per vedere i risultati copiati da qualsiasi browser. Se lo attivi, la dashboard web è una vista aggiuntiva; l'app desktop continua a controllare il runtime VPS via SSH.
  • Il container gira con restart: unless-stopped, così il team sopravvive automaticamente ai riavvii.
🖥️ Preferisci niente terminale? L'app desktop può connettersi a un team in esecuzione su un VPS e controllarlo — avvialo, fermalo e monitoralo dal tuo computer. Vedi come eseguirlo.
🔒 Un team per utente. Non far girare un team locale e un team su VPS contemporaneamente — divide la fonte di verità e rompe la sincronizzazione. Scegli un'unica posizione per sessione.
Going deeper

These docs are the essentials. For the full detail, the exact flags and the code itself, read the source: VPS-SETUP.md