Licensed to be used in conjunction with basebox, only.
// integration
DokuWiki
Applies to
Product: Cloud · Server · Audience: Administrator
The DokuWiki connector lets the basebox assistant search and read pages from a self-hosted DokuWiki instance — for example, your internal knowledge base, clinical SOPs, or runbooks.
When to use it
Enable DokuWiki when you want the assistant to:
- answer questions grounded in your wiki content,
- cite or link directly to wiki pages in its answers,
- discover and summarise existing documentation rather than re-explaining it from scratch.
Configuration
DokuWiki works with personal credentials: the administrator sets the connector up once, and each user adds their own DokuWiki token. That way each person sees through basebox exactly the pages they may see in the wiki (Connector authentication).
As administrator, find DokuWiki on the Admin → Connectors page and fill in:
| Field | Description |
|---|---|
| Endpoint URL | The XML-RPC endpoint of your DokuWiki (typically https://wiki.example.org/lib/exe/xmlrpc.php). On basebox Server the Platform Operator can also set it via Helm (Connector configuration). |
| Base URL info | Free-form text describing the public-facing base URL of your wiki, e.g. https://wiki.example.org/doku.php?id=<page>. basebox injects this into the assistant's context so it can produce correct, clickable links to your wiki pages. |
Then:
- Click Test connection to verify the endpoint.
- Toggle the connector On and enable it in the apps where it should be available.
As a user, add your own DokuWiki access token to the connector and check it with Test connection. Token authentication must be enabled in your DokuWiki instance. Where to enter the token is described under Connectors.
Behaviour in chat
When DokuWiki is enabled and a user asks something the assistant can answer from the wiki:
- The assistant searches the wiki, reads relevant pages, and answers using their content.
- Links to wiki pages are rendered to open in a new browser tab, so the user's chat is not interrupted.
- The assistant uses the Base URL info value to construct correctly-formatted links to your wiki.
Tips
- The fewer tools the assistant has to choose from, the better it tends to perform — only enable DokuWiki if your users actually have a wiki to reference.
- Each person sees through basebox only what their own wiki permissions allow. No shared wiki user is needed.
- If the administrator changes the endpoint URL, the change takes effect immediately — no restart needed.
Limitations
- Only one DokuWiki instance can be connected at a time.
- Pages behind ACLs the respective user cannot see will not be returned.