Files
ProxmoxVEDHelperScripts/json/paperclip.json

69 lines
3.0 KiB
JSON

{
"name": "Paperclip",
"slug": "paperclip",
"categories": [
20
],
"date_created": "2026-04-15",
"type": "ct",
"updateable": true,
"privileged": false,
"interface_port": 3100,
"documentation": "https://docs.paperclip.ing/",
"website": "https://paperclip.ing/",
"logo": "https://github.com/paperclipai.png",
"description": "Paperclip is an open-source orchestration platform for managing autonomous AI agent teams with goals, routines, governance, and a browser-based control plane.",
"install_methods": [
{
"type": "default",
"script": "ct/paperclip.sh",
"config_path": "/opt/paperclip/.env",
"resources": {
"cpu": 4,
"ram": 8192,
"hdd": 20,
"os": "Debian",
"version": "13"
}
}
],
"default_credentials": {
"username": null,
"password": null
},
"notes": [
{
"text": "The installer attempts Paperclip authenticated/private onboarding for LAN access. If a Paperclip release falls back to local quickstart behavior, first access will not require login and you can switch modes later with `pnpm paperclipai configure --section server`.",
"type": "info"
},
{
"text": "Persistent Paperclip runtime data is stored in `/opt/paperclip-data`, while the application code lives in `/opt/paperclip`.",
"type": "info"
},
{
"text": "Database credentials are stored in `~/paperclip.creds`. These are PostgreSQL credentials generated by the shared helper, not the Paperclip web login or Codex/Claude authentication.",
"type": "info"
},
{
"text": "If authenticated mode is active, the installer saves the current CEO bootstrap invite in `~/paperclip.creds`. Open that invite to finish the initial admin setup. You can generate a fresh invite later with `cd /opt/paperclip && set -a && source /opt/paperclip/.env && set +a && pnpm paperclipai auth bootstrap-ceo`.",
"type": "info"
},
{
"text": "If you access Paperclip from a different hostname, update `PAPERCLIP_PUBLIC_URL` in `/opt/paperclip/.env` and restart the `paperclip` service. For authenticated/private hostname access, run `cd /opt/paperclip && set -a && source /opt/paperclip/.env && set +a && pnpm paperclipai allowed-hostname <hostname>` after the first startup.",
"type": "info"
},
{
"text": "If you want to change Paperclip's deployment mode later, run `cd /opt/paperclip && set -a && source /opt/paperclip/.env && set +a && pnpm paperclipai configure --section server`.",
"type": "info"
},
{
"text": "Codex and Claude Code are preinstalled. Because the Paperclip service runs as root, authenticate them as root inside the container so Paperclip can reuse those credentials.",
"type": "info"
},
{
"text": "For Codex, run `codex` and choose ChatGPT login for interactive use, or use API-key authentication for more programmatic workflows. Claude Code can be authenticated by running `claude` and using `/login`, or by providing Anthropic API credentials.",
"type": "info"
}
]
}