Skip to main content

​
Guide

Configure Onyx to use models served by LM Studio. Onyx reads the models loaded in LM Studio, together with their capabilities (vision, reasoning) and context length.
1

Set Up LM Studio and Load Your Models

Download LM Studio from lmstudio.ai and load the models you want to use.Start the LM Studio local server:
LM Studio listens on port 1234 by default.
Use a model with strong instruction-following and tool-use capabilities (for example, Qwen 3.5).
If LM Studio runs on a different machine than Onyx, make sure the server is reachable from the Onyx host (for example, http://<lm-studio-host>:1234).
Running Onyx in Docker on the same machine as LM Studio?By default, LM Studio binds only to 127.0.0.1, which is unreachable from inside an Onyx container. To fix this:
  • In the LM Studio Developer tab, enable Serve on Local Network (or set the host to 0.0.0.0) and restart the server.
  • Use http://host.docker.internal:1234 as the API Base URL instead of http://localhost:1234. Onyx fills in this address when it runs in a container.
See the LM Studio docs for details.
2

Navigate to Language Models

Open the Admin Panel from your user profile icon, then open Language Models.
3

Connect LM Studio

Under Self-hosted & Custom, click Connect on the LM Studio card.Set the API Base URL to your LM Studio server address (for example, http://localhost:1234). Enter the server root. Onyx adds the /v1 path for you.If your LM Studio server requires authentication, paste the key in the optional API Key field.LM Studio provider setup dialog
4

Load Your Models

In the Models section, click Refresh models. Onyx lists the models loaded in LM Studio.
5

Choose Visible Models

In the Models section, select the models that users can pick in chat. If a model is missing, open More Models or type its name and click Add Model.Limiting visible models helps when a provider publishes many models and versions of the same model.
6

Set Models Access

Under Models Access, choose All Users & Agents or Named Groups & Agents.With Named Groups & Agents, only Admins and the User Groups and Agents you name can use the models. Named groups need a Business plan or higher.
7

Connect

Click Connect. Onyx tests the connection with one of the selected models before it saves the provider.