Paperclip

Gebruik

0. SSH naar de server

Verbind met je server als root:

ssh root@<SERVER_IP>

Log in met je wachtwoord.

1. Wissel naar de applicatiegebruiker

Alle Paperclip-bewerkingen moeten worden uitgevoerd onder de toegewezen gebruiker:

su - paperclip

Voer Paperclip NIET uit als root.

2. Eerste installatie (onboarding-wizard)

Voer de interactieve setup uit:

paperclipai onboard

Dit configureert je instantie voor het eerste gebruik.

3. Start Paperclip

Start de applicatie:

paperclipai run

Gebruik tools zoals om het actief te houden na uitloggen tmux

4. Standaardservices

Zodra het actief is (tenzij anders geconfigureerd), stelt het systeem het volgende beschikbaar:

• API-server → http://127.0.0.1:3100/api
• Gezondheidscontrole → http://127.0.0.1:3100/api/health
• UI → http://127.0.0.1:3100

Dit zijn de standaardinstellingen die van toepassing zijn, tenzij je de binding, poort of het domein expliciet wijzigt tijdens de configuratie.

5. Nuttige commando's

# Help / CLI reference
paperclipai --help

# Diagnose issues
paperclipai doctor

# Reconfigure setup
paperclipai configure

# Print environment variables for deployment
paperclipai env

6. Toegang tot de UI via beveiligde tunnel (SSH)

Voer op je lokale machine het volgende uit:

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

Log in met de inloggegevens die op de server zijn opgeslagen op:

/root/.cloudzy-creds

Ga naar http://127.0.0.1:3100 in je lokale browser om de Paperclip UI te openen.

Zorg dat Paperclip actief is op de server, anders zijn de UI en API niet bereikbaar.

Belangrijke paden

• Thuismap: /home/paperclip
• Configuratie: /home/paperclip/.paperclip/instances/default/config.json
• Logboeken/gegevens: /home/paperclip/.paperclip/
• NVM-directory: /home/paperclip/.nvm/

Opmerkingen

• Niet uitvoeren paperclipai opdrachten als root (altijd uitvoeren onder de paperclip gebruiker)
• De paperclip inloggegevens worden veilig opgeslagen in /root/.cloudzy-creds
• Je kunt ook rechtstreeks inloggen als de paperclip gebruiker via SSH: ssh paperclip@<SERVER_IP>
• Schakel bij inloggen als root altijd over naar de applicatiegebruiker voordat je Paperclip-opdrachten uitvoert: su - paperclip
• Uitvoeren onboard alleen bij de eerste installatie
• Gebruik configure later voor wijzigingen