Paperclip

Verwendung

0. SSH in den Server

Verbinde dich als root mit deinem Server:

ssh root@<SERVER_IP>

Melde dich mit deinem Passwort an.

1. Zum Anwendungsbenutzer wechseln

Alle Paperclip-Operationen müssen unter dem dedizierten Benutzer ausgeführt werden:

su - paperclip

Paperclip NICHT als Root ausführen.

2. Ersteinrichtung (Onboarding-Assistent)

Interaktive Einrichtung starten:

paperclipai onboard

Damit wird Ihre Instanz für die erste Verwendung konfiguriert.

3. Paperclip starten

Anwendung starten:

paperclipai run

Um sie nach dem Abmelden weiterlaufen zu lassen, verwende Tools wie tmux

4. Standarddienste

Nach dem Start (sofern nicht anders konfiguriert) stellt das System folgende Endpunkte bereit:

• API-Server → http://127.0.0.1:3100/api
• Gesundheitsprüfung → http://127.0.0.1:3100/api/health
• Benutzeroberfläche → http://127.0.0.1:3100

Das sind die Standardeinstellungen. Sie gelten, bis du Binding, Port oder Domain während der Konfiguration explizit änderst.

5. Nützliche Befehle

# Help / CLI reference
paperclipai --help

# Diagnose issues
paperclipai doctor

# Reconfigure setup
paperclipai configure

# Print environment variables for deployment
paperclipai env

6. Sicherer Zugriff auf die UI (SSH-Tunneling)

Führe auf deinem lokalen Rechner folgenden Befehl aus:

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

Melde dich mit den auf dem Server gespeicherten Zugangsdaten an:

/root/.cloudzy-creds

Navigieren Sie zu http://127.0.0.1:3100 in deinem lokalen Browser, um auf die Paperclip-UI zuzugreifen.

Stelle sicher, dass Paperclip auf dem Server läuft, sonst sind die UI und API nicht erreichbar.

Wichtige Pfade

• Ausgangsverzeichnis: /home/paperclip
• Konfiguration: /home/paperclip/.paperclip/instances/default/config.json
• Protokolle/Daten: /home/paperclip/.paperclip/
• NVM-Verzeichnis: /home/paperclip/.nvm/

Hinweise

• Nicht ausführen paperclipai Befehle als root (immer unter dem paperclip Benutzer)
• Die paperclip Zugangsdaten werden sicher gespeichert in /root/.cloudzy-creds
• Du kannst dich auch direkt als paperclip Benutzer per SSH anmelden: ssh paperclip@<SERVER_IP>
• Wenn du als root angemeldet bist, wechsle vor dem Ausführen von Paperclip-Befehlen immer zum Anwendungsbenutzer: su - paperclip
• Führe onboard nur beim ersten Setup
• Verwende configure später für Änderungen