Creator Chat: setup guide

You run the chat yourself, on your own PC or in your own free cloud accounts. Your fans pay your Stripe account directly. Nobody takes a cut. The only thing you pay Ben is the $5/month license.

Your room has two parts:

When you set the stream offline, the room wipes everything: messages, names, polls, votes, uploads and direct chats. Fans never make accounts.

Step 0: Get your license (2 minutes)

  1. Open the license site at https://aiplayground-chat-gatekeeper.aiplayground226.workers.dev and click Subscribe with Stripe.
  2. Pay $5/month. In test mode, use card 4242 4242 4242 4242.
  3. Copy your license key (it starts with APL1.) and save it somewhere safe.

It's also how you manage or cancel your subscription later, on the license site's "Manage" page.

If your license lapses, VIP and premium lock (VIP checkout, the VIP room and VIP overlay messages). Your General room keeps working, and a notice says that VIP is paused. Your chat checks the license about once a day and keeps working for up to 5 days offline. After you pay, VIP unlocks within 15 minutes. You can also press Recheck on your dashboard.

Step 1: Your own Stripe (for VIP payments)

  1. Make a Stripe account (or use the one you have). Stay in Test mode until

you've tried everything.

  1. Developers → API keys: copy your Secret key (sk_test_...).
  2. Later, once you have your public chat address, go to Developers →

Webhooks → Add endpoint:

payment_intent.canceled, charge.refunded

Refunds are handled by you, in your Stripe dashboard.

Step 2: Fill in your settings

Copy selfhost/chat.env.example to selfhost/chat.env and fill it in: LICENSE_KEY, STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET and ALLOWED_ORIGINS (your public chat address). Leave GATEKEEPER_PUBLIC_KEY and GATEKEEPER_URL as they came in the zip; those point at Ben's license service. This file holds secrets. Don't share it or post it.


Path A: one-click cloud (free tiers)

This uses your own Supabase account (database and chat engine) and your own Cloudflare account (the website).

  1. Make a free project at supabase.com. Note its project ref. It's in the

dashboard URL.

  1. Run ./selfhost/setup-cloud.sh <project-ref>. It creates the tables,

saves your settings as secrets and deploys the chat functions.

  1. Supabase → Authentication → Sign In / Providers: turn on **Anonymous

sign-ins**. Fans use these as their no-account guest names.

  1. Open the Deploy to Cloudflare guide at

https://aiplayground-chat-gatekeeper.aiplayground226.workers.dev/deploy and follow it (download the chat zip, then deploy the website from that folder with Wrangler). When Wrangler asks, fill in:

anon/publishable key (this one is public)

  1. Put your new https://creator-chat.<you>.workers.dev address in

ALLOWED_ORIGINS, then run npx supabase secrets set --env-file selfhost/chat.env.

  1. Stripe webhook URL: https://<project-ref>.supabase.co/functions/v1/stripe-webhook.
  2. Create your dashboard login:

SUPABASE_URL=https://<ref>.supabase.co SUPABASE_SERVICE_ROLE_KEY=<API Keys → service_role> node selfhost/create-admin.mjs

Cost: $0 to start.

allows paid sites.

messages a month, 5 GB egress and 50,000 monthly guests. Free projects pause after a week with no activity, so open your dashboard before you go live.

(then $10 per extra 1,000), 5 million messages (then $2.50 per million) and 250 GB egress. Spend caps are on by default.

use Cloudflare, or Vercel Pro at $20/month. Render's free static hosting works but only includes 5 GB of bandwidth a month.

Path B: your own PC (Docker)

You need Docker Desktop (running) and Node.js 20 or newer.

  1. Download the chat zip from

https://aiplayground-chat-gatekeeper.aiplayground226.workers.dev/download/creator-chat.zip Unzip it and open a terminal in the creator-chat folder.

  1. Fill in selfhost/chat.env (Step 2).
  2. Start it:

The first run downloads about 2 GB. quick prints an instant public https://....trycloudflare.com link.

  1. Put that link in ALLOWED_ORIGINS, and add the Stripe webhook

<link>/functions/v1/stripe-webhook. Run the start command again.

  1. Create your dashboard login: node selfhost/create-admin.mjs.
  2. Open <link>/admin.

Stable link (recommended): quick links change each time you restart. To get a link that doesn't change, use a free Cloudflare account and a domain you own:

  1. Go to Zero Trust → Networks → Tunnels → Create a tunnel (Cloudflared).
  2. Add a public hostname such as chat.yourname.com that points to

http://web:8080.

  1. Put the tunnel token in selfhost/tunnel.env as TUNNEL_TOKEN=....
  2. Start with start.ps1 named or ./selfhost/start.sh named.

Stop, restart, and after a PC reboot

Run these from the creator-chat folder.

Stopping keeps your settings and dashboard login.

used before (for example powershell -ExecutionPolicy Bypass -File selfhost\start.ps1). It's safe to run again at any time. Anything already running is reused, and the rest is restarted.

  1. Open Docker Desktop and wait until it says it's running.
  2. Run the same start line again.

The license check, VIP checkout and Stripe webhook run in the chat functions, which only start when you run the start line. So always run it after a reboot.

old folder (keep your selfhost/chat.env and selfhost/tunnel.env), then run the start line. Database updates are applied automatically, and your data is kept.

Optional: start automatically when you log in (Windows). This step is optional and nothing installs it for you. In Docker Desktop, go to Settings → General and turn on "Start Docker Desktop when you sign in". Then open PowerShell in the creator-chat folder and run:

$a = New-ScheduledTaskAction -Execute "powershell.exe" -Argument "-ExecutionPolicy Bypass -WindowStyle Hidden -File `"$PWD\selfhost\start.ps1`""
$t = New-ScheduledTaskTrigger -AtLogOn -User $env:USERNAME; $t.Delay = "PT2M"
Register-ScheduledTask -TaskName "CreatorChat" -Action $a -Trigger $t

Use start.ps1 named in the argument instead if you use a stable tunnel link. To remove the task, run Unregister-ScheduledTask -TaskName CreatorChat.

Cost: $0. Cloudflare Tunnel is free. The real limit is your home upload speed, because every message goes to every connected fan. As a rough guide, 1,000 fans with 5 messages a second is about 2.5 MB/s (around 20 Mbps) of upload. Keep your VIP cap and slow-mode cooldowns sensible, or use Path A for huge audiences.


Going live with OBS

  1. Open your dashboard (<your link>/admin). At the top you'll find:

the link in your stream title, panels or pinned chat message, or show the QR code on screen.

text color, size, how many messages to show and when they fade. Then click Copy overlay URL.

  1. In OBS: Sources → + → Browser. Paste the overlay URL and set the

size to about 400×600, or whatever fits your layout. Leave "Custom CSS" empty. The background is transparent and the overlay refreshes every 2 seconds.

  1. Keep the overlay URL private, because it contains a secret token. If it

leaks, click New overlay link and paste the new URL into OBS. The old one stops working right away.

  1. On your dashboard, open the rooms (General and/or VIP) and set things up

before you go live. Then press Stream Live when you start streaming. When you finish, set the stream Offline. That closes both rooms and wipes the room.

What your chat stores (on your own database)

WhatWhen it's deleted
Guest names, messages, polls, votes, uploads and direct chatsWhen you set the stream offline
Your settings: price, caps, cooldowns, banned words and pagesKept until you change them
The license status (signed, from the license site)Replaced about once a day
The overlay tokenReplaced when you click "New overlay link"

VIP purchases leave no payment record in your chat. The fan's VIP flag is wiped with the room, and Stripe keeps the receipts in your own Stripe account. Card details never touch your chat.

Deploy to Cloudflare Download for your own PC