Administration
A self-hosted Community Edition install has one or more platform administrators who configure it for everyone. This page covers who the administrator is, each settings page only they can open, and how to keep the install up to date.
Who is the administrator
The administrator pages require the platform administrator role. Being the owner or an admin of an organization is not enough: every user owns their personal organization, and that does not reveal these pages. For a regular user the pages are simply absent from the settings list, and opening one by its address does not give access to it.
Becoming the administrator on a self-hosted install
On a fresh Community Edition install, the first person to register becomes the platform administrator, and lands on the first-run setup wizard (Connect to LiveContext Cloud, API Providers, CLI Providers, Platform Integrations, then You're all set!, or No provider configured when nothing was set up). Completing the wizard marks the install as set up: from then on no later account is promoted automatically, even if every user is removed. See Self-hosting for the wizard and for how teammates join afterwards.
Administrator pages on a self-hosted install
These pages appear in the settings list of a self-hosted administrator, in addition to the pages every user has (see Account & settings).
| Page | What it controls |
|---|---|
| Platform Keys | The OAuth2 and API credentials your integrations use to let users connect their accounts, and which integrations are available. |
| AI Providers | The install’s LLM provider keys, the coding-agent CLI bridges, and the model catalog. |
| Node Types | Which workflow node types are enabled. |
| Cloud | The connection of this install to a LiveContext cloud account, and the signed catalog bundles it receives. |
AI Providers
The page the agents and chat depend on. Its tabs are API Keys (a key per provider), CLI (the CLI bridges, one entry each in its own toggle: Claude Code, Codex, Gemini CLI, Mistral Vibe and Cursor), and Models (which models are enabled). The setup wizard fills the same settings. See Models & providers for each tab in detail.
Platform Keys
The page is titled Platform Credentials. Platform credentials (Client ID, Client Secret, API keys) are what let your users connect their own accounts through OAuth2, configured here instead of environment variables. Each integration card shows Configured or Not configured, and offers:
- A switch that turns the integration on or off for the install, and an expandable list of its endpoints (Endpoints, with how many are active).
- Configure (or Edit) to enter the secret fields. When an integration has several authentication methods, each gets its own tab and can be disabled separately. Leave a secret field empty to keep its current value.
- Pricing, once a credential is saved: publish a Markup Pricing version, a default markup in credits per call plus per-tool overrides. Each publish creates a new version; runs already in flight keep the version they started with.
The page opens on Configured, what is already set up; switch to All Integrations to find what is left to set up. Users then connect their own accounts from Credentials & Variables (see Integrations).
Node Types
Enable or disable workflow node types, filtered by category (Triggers, Actions, Control Flow, AI, Data and more). The page also has Integrations and Capabilities tabs, and a Minimum plan per node, integration endpoint or capability (for example vector search or email alerts).
The node catalog itself is described in Node reference.
Cloud
The Connection tab (Cloud Connection) links this install to a LiveContext cloud account with Connect to Cloud, or unlinks it with Disconnect. The link is what gives your users the cloud marketplace, referral rewards and automatic catalog updates. Once linked, two switches decide what runs through the cloud: LLM source (API model calls on the cloud account, billed in credits) and Integration credentials (integrations on LiveContext's credentials). Both need a paid plan on the cloud account. The Bundles tab shows the sync status of the signed Model catalog, Integrations catalog and Skills bundles, with Sync now. Linking and bundles are detailed in Self-hosting.
Version and updates
On a self-hosted install, Settings > Information starts with a Version card: the Edition, Version, Commit and Built on date of the running build. Every user of the install can see it.
The install checks the public release feed once a day and on startup. When a newer release exists, the card shows Update available (or Security update in red when the release contains a security fix), with How to update and Release notes. A dot also appears on Information in the settings list (red for a security update, amber otherwise). Otherwise the card reads You're on the latest version.
LiveContext never updates itself. How to update gives the commands to run from your cloned LiveContext folder. Pull the repository first: the Compose file pins the release image tag, so without it you would pull the old image again.
git pull
docker compose pull
docker compose up -dYour data is kept, and database migrations run automatically on startup.
Below the version, Optional components shows whether the heavy features that are off by default are enabled: Interface screenshots & PDFs and Browser agent & web search.
Cloud operator pages
The settings code contains more administrator pages that serve the operator of the LiveContext cloud. They never appear on a Community Edition install:
| Page | Purpose |
|---|---|
| Offers | Everything the platform gives, one tab per way: offer links (a campaign that pays), creator codes (one person you choose), a direct grant of credits or a plan to an existing account, the offer free accounts receive by email when their credits run low, and the test of an offer without paying. |
| Partners | The partner program: partner applications, partner codes, and the commissions each code owes. |
| Marketplace payouts | Creator earnings, refunds and the monthly payout run. |
| Tool Health | Tools that failed across the whole platform, spread over accounts to tell a broken catalog entry from one customer credential. |
| Publication Review | Review and approve marketplace publications before they go live. |
| Marketplace Highlights | Pick and order the publications shown in the Highlights row. |
| Verified Accounts | Grant or remove the blue check shown next to a name. Managed cloud only. |
| Agent Debug | Visualize system prompts and test agent tools. |
| Sandbox Reports | Accounts whose code sandbox was suspended after an agent was asked to misuse it, with a way to lift a suspension raised by a false alarm. |
On the cloud, Cloud lists the self-hosted instances connected to the account instead of a connect button.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| Platform Keys, AI Providers and the other administrator pages are missing from the settings list | Your account does not have the platform administrator role. Owning an organization does not count. | Ask the platform administrator of the install (on a fresh install, the first person who registered). |
| The version is unchanged after docker compose pull and docker compose up -d | The Compose file pins the release image tag, so without the new Compose file the old image is pulled again. | Run git pull in your cloned LiveContext folder first, then docker compose pull and docker compose up -d. |
| Update available never shows, although a newer release exists | The install checks the release feed once a day and on startup only, or the check is disabled with CE_VERSIONCHECK_ENABLED=false. | Wait for the next daily check or restart the install, and remove CE_VERSIONCHECK_ENABLED=false if it is set. |
| The Bundles tab shows a last fetch status of “not linked” | The install is not linked to a cloud account, which is the normal state of a fresh install. | Link it with Connect to Cloud on the Connection tab to start receiving catalog updates. |
| Users cannot find an integration to connect | On Platform Keys, the integration is Not configured, or its switch is off. | Configure its credentials on Platform Keys and turn the integration on. |