Skip to main content
This page takes you from nothing to a desk that answers a chat on your site. You need a Cloudflare account and a GitHub account.
Use the Workers Paid plan ($5/month) if you want the AI. On the Free plan, AI replies fail now and then with Cloudflare’s error 1102 because of the 10 ms CPU limit. Everything else runs on Free. See Costs and limits.
1

Press the Deploy button

Open the Deploy button:Deploy to CloudflareCloudflare copies the repo into your GitHub account and creates the Worker, a D1 database, an R2 bucket, a Queue and the Durable Objects. Keep the default resource names unless this Cloudflare account already has a Jun. In that case read Deploy to Cloudflare first.
2

Choose a setup token

The form asks for one secret, SETUP_TOKEN. Enter any passphrase of 16 or more characters.You type it once to create the owner account. Keep it somewhere safe: it’s also how you get back in if you lose every passkey.
3

Open your desk

When the build finishes, open the Worker’s URL (https://jun-desk.<your-subdomain>.workers.dev with the default name). You see Set up your desk.
4

Create the owner and a passkey

Fill in Setup token, Workspace name, Your name and Email, then press Create passkey and finish setup. Your browser asks for a fingerprint, face or device PIN.Passkeys belong to the hostname you create them on. If you plan to use a custom domain, you can move later; see Custom domain.
5

Work through Get started

The desk opens on Get started, one step at a time:
  1. Create your account: already done.
  2. Add your docs: paste your help center or docs URL and press Add website. It reads the sitemap and ticks off when pages are indexed.
  3. Set up the AI assistant: pick Workers AI (built in, no key) and press Turn on the AI.
  4. Make the widget yours (optional): pick your brand colour.
  5. Put it on your site: copy the snippet.
  6. Invite your team (optional): create an invite link.
Each step ticks itself off from the desk’s real state. See Get started checklist for details.
6

Paste the snippet on your site

Put the snippet in your site’s <head>, before your own scripts:
Copy the exact line from the Put it on your site step or from Chat widget → Install. The data-key is your workspace’s public widget key. The step ticks itself off the first time the loader runs on a site other than the desk. See Install the widget.
7

Send your first chat

Open your site, or the desk’s demo page if your site isn’t live yet: the demo page link in the install step opens /demo.html?key=wk_…. Press the chat button and ask something your docs answer.Keep the desk’s Inbox open in another window. The conversation appears live, the AI’s answer streams in with source chips, and you can take over by replying yourself.

​
Try the debug context

The demo page has a Pay invoice button that calls a request which fails with a server error, like a real bug would. Press it, then open the chat and write “I can’t pay my invoice”. The AI sees the failed request, and your team sees it in the conversation’s debug panel. See Debug context.

​
Next steps

Add more passkeys

Add a passkey on a second device so you can’t get locked out.

Identify signed-in users

Let the AI and your team see who the customer is, verified.

Write the AI's instructions

Tone, rules and when to hand off.

Invite your team

Admins and agents, each with their own passkey.