Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

[Support] Paperclip — Open-Source AI Coding Agent Platform for Unraid (DEPRECATED)

Featured Replies

This template is no longer supported. See the announcement below.

Paperclip is an open-source AI coding agent platform that lets you run Claude-powered coding agents on your own server. This image is maintained by BitCryptic and built from the official Paperclip source with Unraid compatibility in mind.

Features

  • Claude-powered coding agents via Anthropic API

  • Web UI served from the same container

  • Authenticated or public deployment modes

  • Tailscale support for private access

Requirements

  • PostgreSQL database — a separate Postgres container (e.g. postgres:16) on the same Docker network

  • Anthropic API key from console.anthropic.com (required for Claude-based agents)

  • A securely generated BETTER_AUTH_SECRET (openssl rand -base64 32)

Installation

Install via Community Applications and search for Paperclip, or drop the template XML directly into /boot/config/plugins/dockerMan/templates-user/ on your Unraid server.

You'll need a PostgreSQL container running before starting Paperclip. The default DATABASE_URL assumes a container named postgres-paperclip on the same Docker network — adjust to match your setup.

Required fields:

  • DATABASE_URL — PostgreSQL connection string (default: postgres://paperclip:password@postgres-paperclip:5432/paperclip)

  • BETTER_AUTH_SECRET — random secret for session signing, generate with openssl rand -base64 32

  • PAPERCLIP_PUBLIC_URL — the URL users will access Paperclip from (e.g. http://your-server-ip:3100 or your Tailscale hostname)

  • PAPERCLIP_DEPLOYMENT_MODE — authenticated for private use, public for open access (default: authenticated)

  • ANTHROPIC_API_KEY — required for Claude-based agents

After starting the container, access the web UI at http://your-server-ip:3100.

Notes

Paperclip requires a PostgreSQL database — it will not start without a valid DATABASE_URL. If you don't already have a Postgres container, add one first and put both on the same Docker network.

PAPERCLIP_PUBLIC_URL must match the URL you actually use to access Paperclip — if this is wrong, auth callbacks will fail. If accessing from multiple URLs (e.g. local IP and Tailscale hostname), set BETTER_AUTH_TRUSTED_ORIGINS to a comma-separated list of all valid origins.

For private access, Tailscale is supported — enable it in the template and set PAPERCLIP_PUBLIC_URL to your Tailscale hostname.

Links

Post any issues or questions here and I'll do my best to help.

Edited by BitCryptic
end of support

  • Author

please move to docker container area

  • 3 weeks later...
  • Author

Update — 2026-05-31

The image has been updated to track upstream v2026.529.0 (released 2026-05-29). If you're running the CA template, it already uses :latest so just stop the container, remove the image, and recreate — it will pull the updated image automatically.

Notable upstream changes since the original post:

- v2026.517.0 — Grok Build is now a first-class local runtime (adapter registry, UI, CLI, session handling)

- v2026.529.0 — Inline document annotations and comments on issues, with revision-aware anchor snapshots

No template changes required. Post any issues here and I'll do my best to help.

  • 2 months later...

Hi, any updates plan for paperclip ?

Thanks

  • BitCryptic changed the title to [Support] Paperclip — Open-Source AI Coding Agent Platform for Unraid (DEPRECATED)
  • 5 weeks later...
  • Author

Paperclip template: no longer supported

I've stopped maintaining the Paperclip template and the bitcryptic/paperclip image, and I've marked the template as deprecated in Community Applications. I've retired Paperclip from my own setup, so I can't keep it properly maintained.

@NeZios — to answer your question from August: there won't be any further updates from me. Sorry for the slow reply.

What this means for you:

  • The last image build tracks upstream v2026.529.0 (31 May 2026). No more builds, fixes or support from me.

  • Existing installs keep running. The image will stay on Docker Hub for now, so you can still recreate the container. You don't have to uninstall anything, but you won't receive updates, including security fixes.

  • If you want to keep up with Paperclip, the upstream project is at https://github.com/paperclipai/paperclip. My build added a root-to-node entrypoint fix and Tailscale support for Unraid, so if you move to upstream you'll need to cover those yourself.

Thanks to everyone who tried it and gave feedback.

On 5/13/2026 at 8:57 PM, BitCryptic said:

This template is no longer supported. See the announcement below.

Paperclip is an open-source AI coding agent platform that lets you run Claude-powered coding agents on your own server. This image is maintained by BitCryptic and built from the official Paperclip source with Unraid compatibility in mind.

Features

  • Claude-powered coding agents via Anthropic API

  • Web UI served from the same container

  • Authenticated or public deployment modes

  • Tailscale support for private access

Requirements

  • PostgreSQL database — a separate Postgres container (e.g. postgres:16) on the same Docker network

  • Anthropic API key from console.anthropic.com (required for Claude-based agents)

  • A securely generated BETTER_AUTH_SECRET (openssl rand -base64 32)

Installation

Install via Community Applications and search for Paperclip, or drop the template XML directly into /boot/config/plugins/dockerMan/templates-user/ on your Unraid server.

You'll need a PostgreSQL container running before starting Paperclip. The default DATABASE_URL assumes a container named postgres-paperclip on the same Docker network — adjust to match your setup.

Required fields:

  • DATABASE_URL — PostgreSQL connection string (default: postgres://paperclip:password@postgres-paperclip:5432/paperclip)

  • BETTER_AUTH_SECRET — random secret for session signing, generate with openssl rand -base64 32

  • PAPERCLIP_PUBLIC_URL — the URL users will access Paperclip from (e.g. http://your-server-ip:3100 or your Tailscale hostname)

  • PAPERCLIP_DEPLOYMENT_MODE — authenticated for private use, public for open access (default: authenticated)

  • ANTHROPIC_API_KEY — required for Claude-based agents

After starting the container, access the web UI at http://your-server-ip:3100.

Notes

Paperclip requires a PostgreSQL database — it will not start without a valid DATABASE_URL. If you don't already have a Postgres container, add one first and put both on the same Docker network.

PAPERCLIP_PUBLIC_URL must match the URL you actually use to access Paperclip — if this is wrong, auth callbacks will fail. If accessing from multiple URLs (e.g. local IP and Tailscale hostname), set BETTER_AUTH_TRUSTED_ORIGINS to a comma-separated list of all valid origins.

For private access, Tailscale is supported — enable it in the template and set PAPERCLIP_PUBLIC_URL to your Tailscale hostname.

Links

Post any issues or questions here and I'll do my best to help.

Thanks for sharing the template and installation details. The PostgreSQL requirement and the explanation of PAPERCLIP_PUBLIC_URL are particularly helpful for avoiding configuration issues. It would be useful to have a short migration guide or announcement explaining why this template is no longer supported and what Unraid users should use instead. That would make it easier for existing users to plan their next steps without running into compatibility problems.

  • Author
21 hours ago, indebtedph said:

Thanks for sharing the template and installation details. The PostgreSQL requirement and the explanation of PAPERCLIP_PUBLIC_URL are particularly helpful for avoiding configuration issues. It would be useful to have a short migration guide or announcement explaining why this template is no longer supported and what Unraid users should use instead. That would make it easier for existing users to plan their next steps without running into compatibility problems.

I can take a look at upstream and work out what steps are involved with switching to the main repo using this template.

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.