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

ProductRoute
Jiragear SettingsAppsAnyLLM Chat — Settings
Confluencegear SettingsAnyLLM 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-admins or confluence-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.

The settings consist of nine sections, shown as tabs at the top of the page in this order:

SectionWhat it containsPage
Homeoverview cards with live counts and the security modelThe Home page
ConnectionsLLM connections: name, provider type, endpoint, models, API key; connection testSetting Up LLM Connections
Endpoint approvalswhich addresses the app may reach; approval status per product; replace, revoke, re-approveManaging Endpoint Approvals
Agentssite agents (up to 8) with instructions, optional model and tool levelProviding Agents, Prompts and Skills for Everyone
Prompts & Skillstemplates and skills for everyone (up to 30)Providing Agents, Prompts and Skills for Everyone
Usagerequests and tokens of the installation, current and previous month, by modelUsage Statistics, Import/Export and Backup
Import/Exportimport from LibreChat, LiteLLM or an AnyLLM export; JSON exportUsage Statistics, Import/Export and Backup
Modulesthe 14 toggles for the surfaces in Confluence, Jira and across productsModules: Switching Surfaces On and Off
Generalinterface language, default model, AI access, rate limit, site knowledge, web search, image generationGeneral Settings, Enabling Web Search and Image Generation
Tab row of the settings with the nine sections; the button at the right switches between the Jira and Confluence view of the same configuration.
  • 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.

CardText 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.

The Home page of the settings: seven cards with live counts for each section and the security-model summary below.

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.

StepActionWhy in this order
1Modules — for now, leave only the surfaces active that you want to start with, then Saveprevents entry points from appearing everywhere before anything works
2Connections — create the connection with endpoint, models and API key, click Save connections and confirm Atlassian's approval dialogwithout a connection the chat is locked; the dialog approves the address for the product you are working in
3Endpoint approvals in the other product — switch with the product button, click Approve now in the Approval status per product table and confirm the dialog thereapprovals count per product; until then every request in that product fails
4Test connection on the Connections page — ideally in Jira and in Confluencechecks address and key; a successful test also clears a "blocked" entry for that product
5General — interface language, default model, AI access, rate limit, then Savedetermines what users find
6Your own test chat in Jira and in Confluencethe last check before release
7Agents and Prompts & Skills (each with its own Save button)convenience, not a requirement
8Optionally Site knowledge (for the AI), 🌐 Web search and 🎨 Image generation on Generaleach has its own prerequisites; a search service also needs an endpoint approval in both products
9Modules — enable the remaining surfaces, then Savefrom 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 + writeRead 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 changeWhat users noticeTakes effect
Adding a connection (with key and approval in both products)new models in the model selectionimmediately
Deleting an API keythe models of that connection disappear from the selectionimmediately
Last usable connection removedbanner 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 modelonly affects people who have not chosen a model themselveson next opening
Endpoint approval missing or revoked in a productin 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 unaffectedimmediately
AI access set to Offno 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 onlyno 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 Confluenceimmediately
Disabling a surfacethe 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 noticeimmediately (chat bar up to 10 minutes later)
Deleting a site agentthe agent disappears from the selection; old conversations continue without itimmediately
Creating a template or skillappears in the menu of the chaton next opening
Changing the interface languagechat and settings change languageon next opening
Changing site knowledgeanswers take the new details into accountfrom the next request
Switching off web search or image generationthe AI no longer searches the web or generates imagesimmediately
The subscription becomes inactivenew answers and ✓ Execute are blocked; history, memory, agents, skills and the settings keep workingimmediately

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