Graffetta per fogli

Utilizzo

0. SSH nel server

Connettiti al tuo server come root:

ssh root@<SERVER_IP>

Accedi utilizzando la tua password.

1. Passare all'utente dell'applicazione

Tutte le operazioni di Paperclip devono essere eseguite dall'utente dedicato:

su - paperclip

NON eseguire Paperclip come root.

2. Prima configurazione (procedura guidata di onboarding)

Esegui la configurazione interattiva:

paperclipai onboard

Questo configura la tua istanza per il primo utilizzo.

3. Avvia Graffetta

Avvia l'applicazione:

paperclipai run

Per mantenerlo in esecuzione dopo il logout, utilizzare strumenti come tmux

4. Servizi predefiniti

Una volta eseguito (a meno che non venga riconfigurato), il sistema espone:

• Server API → http://127.0.0.1:3100/api
• Controllo sanitario → http://127.0.0.1:3100/api/health
• Interfaccia utente → http://127.0.0.1:3100

Queste sono le impostazioni predefinite e verranno applicate a meno che non si modifichi esplicitamente l'associazione, la porta o il dominio durante la configurazione.

5. Comandi utili

# Help / CLI reference
paperclipai --help

# Diagnose issues
paperclipai doctor

# Reconfigure setup
paperclipai configure

# Print environment variables for deployment
paperclipai env

6. Accedi all'interfaccia utente in modo sicuro (tunneling SSH)

Dal tuo computer locale, esegui:

ssh -L 3100:127.0.0.1:3100 paperclip@<SERVER_IP>

Accedi utilizzando le credenziali memorizzate sul server all'indirizzo:

/root/.cloudzy-creds

Vai a http://127.0.0.1:3100 nel browser locale per accedere all'interfaccia utente di Paperclip.

Assicurati che Paperclip sia in esecuzione sul server, altrimenti l'interfaccia utente e l'API non saranno accessibili.

Percorsi importanti

• Directory principale: /home/paperclip
• Configurazione: /home/paperclip/.paperclip/instances/default/config.json
• Registri/dati: /home/paperclip/.paperclip/
• Directory della MNV: /home/paperclip/.nvm/

Note

• Non correre paperclipai comandi come root (eseguire sempre sotto il file paperclip utente)
• IL paperclip le credenziali dell'utente sono archiviate in modo sicuro /root/.cloudzy-creds
• Puoi anche accedere direttamente come paperclip utente che utilizza SSH: ssh paperclip@<SERVER_IP>
• Una volta effettuato l'accesso come root, passa sempre all'utente dell'applicazione prima di eseguire qualsiasi comando Paperclip: su - paperclip
• Correre onboard solo alla prima configurazione
• Utilizzo configure più tardi per le modifiche