Coming soon. The Wiki is in active development, so features and these docs may still change. Early adopters: contact us for access.

Frequently asked questions

Answers to the questions administrators ask most

1. Licensing

  • How do I get a licence? Read the installation ID (setup wizard, Settings → Application → Licensing, or ./wiki-server --machine-id) and send it through vectored.dev/#contact or to support@vectored.dev. See Licensing.
  • Why is there no Analytics menu? Page analytics need a Pro licence.
  • What happens when the licence expires? Any grace period first, with banners; then only sign-in, health checks and the licence page answer, until a new licence is applied. Nothing is deleted.
  • Does the Wiki call home? No. It doesn't need internet access to check its licence.

2. Installation

  • Do I need Redis? Not for a single server. A cluster needs it. See Single server & cluster.
  • Which PostgreSQL? 15 or later; managed services work.
  • People can't edit pages together; the editor says it can't connect. Route /api/ws to the server with WebSocket upgrades allowed. See Install the Wiki.
  • Video uploads fail with 413. The proxy in front of the Wiki refuses large bodies: let it take 201 MiB (nginx: client_max_body_size 201m).
  • Can I set it up with no browser? Yes: Set up without the UI.

3. Content

  • How do we move from Confluence? Export each space (XML, full export) and import it into a Wiki space: Imports. Importing again later updates what the first import made.
  • Who can create spaces? Super admins. They then hand a space to its team with the Admin role.
  • How do we publish a space to the internet? Turn on anonymous access, make the space public, and choose what search engines may index.

4. Access

  • I'm locked out: single sign-on is down. Start one server with SSO_ENFORCEMENT_OVERRIDE=true, sign in with a password as a super admin, fix the provider, then remove the variable.
  • An account is locked after failed sign-ins. It unlocks after AUTH_LOCKOUT_DURATION (15 minutes), or an administrator unlocks it in Settings → Access management → Users.
  • Someone's calendar address leaked. They make a new one on the Calendar page; ending their sessions also stops it. See Calendar feeds.
  • Why does everyone seem to come from the same address? The web app ignores forwarding headers unless FRONTEND_BEHIND_PROXY=true is set on it, and the server trusts them only from the proxies in TRUSTED_PROXIES. Set both; see Install the Wiki.

5. Data

  • What's in a backup? See Backups.
  • I lost CONFIG_ENCRYPTION_KEY. Stored credentials and backups made with it can't be read; there is no recovery. Keep the key in a secret store and with your backup records.
  • How long are page views kept? Raw views 90 days, daily totals as long as the page. See Analytics.