Paperclip

Utilizzo

0. SSH nel server

Connettiti al server come root:

ssh root@<SERVER_IP>

Accedi con la tua password.

1. Passa all'utente dell'applicazione

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

su - paperclip

NON eseguire Paperclip come root.

2. Configurazione iniziale (procedura guidata)

Avvia la configurazione interattiva:

paperclipai onboard

Questo prepara l'istanza per il primo utilizzo.

3. Avvia Paperclip

Avvia l'applicazione:

paperclipai run

Per mantenerla attiva dopo il logout, usa strumenti come tmux

4. Servizi predefiniti

Una volta avviato (salvo diversa configurazione), il sistema espone:

• Server API → http://127.0.0.1:3100/api
• Controllo dello stato di salute → http://127.0.0.1:3100/api/health
• Interfaccia utente → http://127.0.0.1:3100

Queste sono le impostazioni predefinite e restano valide a meno che non si modifichi esplicitamente il binding, 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 in modo sicuro (tunneling SSH)

Dal tuo computer locale, esegui:

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

Accedi usando le credenziali memorizzate sul server in:

/root/.cloudzy-creds

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

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

Percorsi Importanti

• Cartella home: /home/paperclip
• Configurazione: /home/paperclip/.paperclip/instances/default/config.json
• Registri/dati: /home/paperclip/.paperclip/
• Directory NVM: /home/paperclip/.nvm/

Note

• Non eseguire paperclipai i comandi come root (esegui sempre con l'utente paperclip utente)
• Il paperclip le credenziali utente sono memorizzate in modo sicuro in /root/.cloudzy-creds
• Puoi anche accedere direttamente come utente paperclip usando SSH: ssh paperclip@<SERVER_IP>
• Quando sei connesso come root, passa sempre all'utente dell'applicazione prima di eseguire qualsiasi comando Paperclip: su - paperclip
• Esegui onboard solo alla prima configurazione
• Usa configure in seguito per le modifiche