Administration & Configuration
Opening the Settings and Initial Setup
This page shows how to reach the AnyLLM settings (administration page, admin UI, app configuration) in Jira and in Confluence, how the settings are organised, what the Home page tells you, in which order a first setup is safe, and what your later changes mean for the people using the chat.
What this does
The settings page AnyLLM Chat — Settings is the one place where AnyLLM is configured: LLM connections and API keys, endpoint approvals, site agents, templates and skills, usage statistics, import/export, module toggles and general settings. Because AnyLLM is one installation for Jira and Confluence, the page shows the same configuration in both products — only the endpoint approvals are confirmed per product (see Administration & Configuration).
Who can do this
Jira administrators and Confluence administrators. The settings page is protected by Atlassian: in Jira it requires Jira administration, in Confluence it requires Confluence administration. Endpoint approvals are additionally meant to be managed by Jira administrators — see Managing Endpoint Approvals.
Opening the settings
| Product | Route |
|---|---|
| Jira | gear Settings → Apps → AnyLLM Chat — Settings |
| Confluence | gear Settings → AnyLLM Chat — Settings |
A shortcut exists inside the chat: administrators see a Settings button (gear icon, tooltip App settings (admins only)) — at the bottom of the sidebar on the app page, the fullscreen overlay and the standalone full page (as an icon when the sidebar is collapsed), and in the header of the Confluence macro and of the Jira issue navigator dialog. The compact surfaces (issue panel, issue sidebar panel, issue action, assistant dialog below the page title) do not show it.
How the chat decides whether to show the button:
- Jira: a real check of the administrator permission.
- Confluence: a group heuristic — the button appears if you are a member of one of the groups
administrators,confluence-administrators,site-adminsorconfluence-admins. If your organisation grants Confluence administration through other groups, the button is missing; the route via Settings works regardless.
The button only controls visibility; the settings page itself is always protected by Atlassian.
Navigating the settings
The settings consist of nine sections, shown as tabs at the top of the page in this order:
| Section | What it contains | Page |
|---|---|---|
| Home | overview cards with live counts and the security model | The Home page |
| Connections | LLM connections: name, provider type, endpoint, models, API key; connection test | Setting Up LLM Connections |
| Endpoint approvals | which addresses the app may reach; approval status per product; replace, revoke, re-approve | Managing Endpoint Approvals |
| Agents | site agents (up to 8) with instructions, optional model and tool level | Providing Agents, Prompts and Skills for Everyone |
| Prompts & Skills | templates and skills for everyone (up to 30) | Providing Agents, Prompts and Skills for Everyone |
| Usage | requests and tokens of the installation, current and previous month, by model | Usage Statistics, Import/Export and Backup |
| Import/Export | import from LibreChat, LiteLLM or an AnyLLM export; JSON export | Usage Statistics, Import/Export and Backup |
| Modules | the 14 toggles for the surfaces in Confluence, Jira and across products | Modules: Switching Surfaces On and Off |
| General | interface language, default model, AI access, rate limit, site knowledge, web search, image generation | General Settings, Enabling Web Search and Image Generation |
- Switching to the other product: at the right of the tab row sits a button with an arrows icon and the name of the other product — Confluence when you are in Jira, Jira when you are in Confluence (tooltip: Open these settings in the other product (same configuration)). It opens the same configuration on the other product's settings page — the place where you grant that product's endpoint approvals.
- Keyboard: with a tab focused, Arrow Left and Arrow Right move between the sections, Home jumps to Home and End to General.
- Saving: the Save buttons on Connections (Save connections), Modules and General save the whole configuration at once — including connection cards you have edited but not yet saved and API keys typed there — and open Atlassian's approval dialog when a new endpoint is involved. Agents and Prompts & Skills have their own Save agents and Save prompts buttons.
The Home page
Home shows a short lead text and seven cards with live counts; clicking a card opens the corresponding section.
| Card | Text on the card (example values) |
|---|---|
| LLM connections | "2 of 5 connected — OpenAI-compatible endpoints (LiteLLM, OpenAI, OpenRouter …), each with its own API key and model list." |
| Agents | "3 predefined — assistants with fixed instructions, an optional model and a limited tool level. Users can also create and share their own agents." |
| Prompts & Skills | "4 templates — reusable prompts with placeholders (e.g. {{Project}}) that users fill in and insert in the chat." |
| Modules | "12 of 14 surfaces enabled — control which chat entry points appear in Jira/Confluence." |
| Usage | "Requests & tokens for this installation — current and previous month, broken down by model." |
| Import/Export | "Import from LibreChat/LiteLLM, JSON export." |
| General | "Default model and AI access to Jira/Confluence (currently: …)" — shows Off, Read only or Read + write |
At the bottom the security model is summarised in one line: Security model: API keys never in the frontend · AI only with user permissions (asUser) · write actions only after confirmation in the chat · the app reaches no LLM endpoint you have not approved yourself.
Two notices can appear above the tabs on every settings page, not only on Home:
- a red alert, for example Configuration could not be loaded: … — the rest of the page is then not reliable; reload the page and, if the alert persists, see Troubleshooting;
- a yellow notice These endpoint domains are configured but not yet approved for this installation: … Until you approve them, requests to them are blocked — this typically happens after importing a configuration. with an Approve now button — see Managing Endpoint Approvals.
Installation order
AnyLLM is installed in Jira first; Confluence is then added to the same installation. A Confluence-only installation is not possible. Uninstalling the app from Jira removes it everywhere — together with the entire app storage of both products (configuration, conversations, memory, agents, templates, usage counters). See Licence, Data Retention and Automatic Deletion.
Safe order for initial setup
This order avoids states in which users see a half-configured app.
| Step | Action | Why in this order |
|---|---|---|
| 1 | Modules — for now, leave only the surfaces active that you want to start with, then Save | prevents entry points from appearing everywhere before anything works |
| 2 | Connections — create the connection with endpoint, models and API key, click Save connections and confirm Atlassian's approval dialog | without a connection the chat is locked; the dialog approves the address for the product you are working in |
| 3 | Endpoint approvals in the other product — switch with the product button, click Approve now in the Approval status per product table and confirm the dialog there | approvals count per product; until then every request in that product fails |
| 4 | Test connection on the Connections page — ideally in Jira and in Confluence | checks address and key; a successful test also clears a "blocked" entry for that product |
| 5 | General — interface language, default model, AI access, rate limit, then Save | determines what users find |
| 6 | Your own test chat in Jira and in Confluence | the last check before release |
| 7 | Agents and Prompts & Skills (each with its own Save button) | convenience, not a requirement |
| 8 | Optionally Site knowledge (for the AI), 🌐 Web search and 🎨 Image generation on General | each has its own prerequisites; a search service also needs an endpoint approval in both products |
| 9 | Modules — enable the remaining surfaces, then Save | from here on all users see the app |
Changes during operation
- Rotating an API key: enter the new key in the API key field of the connection and click Save connections. The new key is used immediately, without downtime; leaving the field empty keeps the old key.
- Moving an endpoint: change the Endpoint of the connection, click Save connections and confirm Atlassian's dialog for the new address (or approve the new address beforehand under Endpoint approvals). After a successful save the app automatically revokes approvals that no saved connection or search service uses any more — the old address needs no manual revocation. Then grant the approval for the new address in the other product as well (Approve now in the Approval status per product table).
- Tightening AI access (for example Read + write → Read only): takes effect immediately. Suggestion cards that are still open can no longer be executed; clicking ✓ Execute then fails with "Write actions are not enabled by the admin."
- Removing a connection or deleting its key: its models disappear from every user's selection immediately; details in Setting Up LLM Connections.
Effects of admin changes on users
| Your change | What users notice | Takes effect |
|---|---|---|
| Adding a connection (with key and approval in both products) | new models in the model selection | immediately |
| Deleting an API key | the models of that connection disappear from the selection | immediately |
| Last usable connection removed | banner Not configured yet — an administrator sets the endpoint, models and API key in the app settings (Jira: Settings → Apps · Confluence: Settings → AnyLLM).; the input field is locked with Configuration by an admin required. | immediately |
| Changing the default model | only affects people who have not chosen a model themselves | on next opening |
| Endpoint approval missing or revoked in a product | in that product, sending fails with The endpoint {host} is not approved for {p} yet — endpoint approvals apply per product. An administrator can grant it in the AnyLLM settings of {p} under "Endpoint approvals".; the other product is unaffected | immediately |
| AI access set to Off | no page or issue context, no search, no suggestion cards; page quick actions are locked (text-selection quick actions keep working) | immediately |
| AI access set to Read only | no more suggestion cards; open cards fail with "Write actions are not enabled by the admin." | immediately |
| Lowering the rate limit | "Hourly limit reached (N requests/hour) — please try again later." — one counter per person across Jira and Confluence | immediately |
| Disabling a surface | the menu entry stays but only shows This feature has been disabled by your administrator.; the Confluence chat bar disappears; the link Open as full page stays but the page shows the notice | immediately (chat bar up to 10 minutes later) |
| Deleting a site agent | the agent disappears from the selection; old conversations continue without it | immediately |
| Creating a template or skill | appears in the + menu of the chat | on next opening |
| Changing the interface language | chat and settings change language | on next opening |
| Changing site knowledge | answers take the new details into account | from the next request |
| Switching off web search or image generation | the AI no longer searches the web or generates images | immediately |
| The subscription becomes inactive | new answers and ✓ Execute are blocked; history, memory, agents, skills and the settings keep working | immediately |
Related topics
Rendered from the app’s own interface with sample data; the Jira/Confluence frame around it is not shown.
Documentation baseline: app version 0.2.0 · 2026-08-30