# Paperclip

Paperclip is an open-source artificial intelligence (AI) coding agent platform for self-hosting Claude-based coding agents. It is open source and self-hosted, installable on Docker Hub, Proxmox, ZimaOS, Unraid and Umbrel.

Canonical page: https://ourlocalhost.com/app/2173/paperclip

## Description

Paperclip is an open-source artificial intelligence (AI) coding agent platform for self-hosting Claude-based coding agents. It provides a web-based interface for configuring, running, and managing AI agents. It is aimed at developers and homelab users who want a locally controlled alternative to hosted agent services. This BitCryptic image is no longer maintained as of 2026-09-20, remains available for existing installs, and requires PostgreSQL, an Anthropic API key, and public URL configuration.

## Platform availability

Available on 6 of 10 platforms: Unraid, TrueNAS, Umbrel, ZimaOS, Proxmox, Any server.

## Health score

92/100 (Excellent), based on 4 of 4 factors.
- Maintained: 100 (last commit 17 days ago)
- Popular: 100 (111,064 GitHub stars)
- Easy to install: 85 (6 install platforms, install notes, Docker image)
- Light to run: 70 (1 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/bitcryptic/paperclip
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=paperclip
- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/paperclip
- GitHub: https://github.com/paperclipai/paperclip
- Unraid: https://ca.unraid.net/apps/paperclip-1khajpx0l4tpep?q=Paperclip
- Umbrel: https://apps.umbrel.com/app/paperclip
- Official website: https://paperclip.ing

## Common questions

### Do I need to run onboarding before starting Paperclip?

Yes. Run paperclipai onboard first so Paperclip creates its config, the PAPERCLIP_AGENT_JWT_SECRET in the .env file, and a local secrets key. Without these files the app may not start properly or agents may not be able to connect.

### How do I let other devices on my LAN access a local Paperclip install?

If other devices on your LAN should reach Paperclip, run paperclipai onboard --bind lan. Without this, the default local setup may only answer from the machine where Paperclip is installed.

### How do I update a self-hosted Paperclip instance?

On a managed install, run paperclipai update or upgrade. It backs up the database, swaps the payload, hot-restarts an active service, and auto-rolls back if the new build is unhealthy. Other install types use npm, image pull, or git plus migrate.

### What should I check when Paperclip agents won’t run?

Diagnose heartbeat failures, stuck runs, API auth errors, and agent pausing. These are common agent execution problems.

### Does the Paperclip self-hosting guide cover reverse proxy setup?

Yes. It covers Linux setup, configuration, reverse proxy, and keeping Paperclip updated.

## Alternatives

- Microsoft Foundry: Platform-as-a-service on Azure unifying agents, models, and tools with tracing, monitoring, role-based access control, and support for 1,90…
- Orbitagents: Deploy AI agents that come with tools and context wired in from the get go.

---
Source: Our Local Host (https://ourlocalhost.com/app/2173/paperclip), the self-hosted and open-source app directory.
