Notice: The Witty browser extension is currently offline. The information on these pages may not reflect the current status of our services.
Back to home
  1. Help Center
  2. Witty Works Help Center

How do I connect Witty to my own server?

Point Witty at your own deployment instead of the hosted one.

If you run your own Witty backend, you can tell the browser extension to use it. You do not need a custom build of the extension. Everything is configured from its options page.

Open the options page

  1. Go to chrome://extensions in your browser.
  2. Find Witty, click Details, then Extension options.

Choose how you sign in

The options page offers two connection modes. Pick the one that matches what you run:

  • Account: you run both the dashboard and the NLP API. Users sign in with an account, and team settings, the dictionary and domain settings all work as normal.
  • API key: you run only the NLP API. See Can I use Witty without the dashboard?

Account mode

Fill in three fields:

  • NLP API URL: where text is checked.
  • Dashboard URL: where users sign in.
  • OAuth client ID: the ID of the client you registered on your dashboard.

On your dashboard, register the extension as a public (PKCE) client. There is no client secret, because anyone who installs a browser extension can read its contents, so a secret could not stay secret. Register the redirect URI shown on the options page exactly as displayed; it is matched character for character, so even a missing trailing slash will stop sign-in from completing.

Rules the extension enforces

A few things are deliberately not configurable, because they protect your credentials:

  • Addresses must use https. The only exception is localhost and 127.0.0.1, so you can test against a server on your own machine.
  • Changing the connection signs you out. A sign-in or an API key is only ever valid for the server it came from, so it is never carried across to another one.
  • The connection can only be changed here, on the extension's own options page. No website, link or message can change it for you.
  • Your own server never becomes the default. Choosing Reset to default always returns you to the deployment the extension shipped with.

Something not working?

If sign-in opens and then fails, the redirect URI registered on your dashboard almost certainly does not match the one shown on the options page. If text is never checked, confirm the NLP API URL is reachable from your browser and served over https.