Settings Reference
Open Settings from the gear icon in the left sidebar. The Documentation entry just above it opens this documentation site in your browser. Settings are organised into three tabs.
Connections tab
Section titled “Connections tab”PLC connection
Section titled “PLC connection”A toggle at the top of this section lets you choose the connection method: S7 WebServer (default), OPC UA, or Demo (a simulated PLC that needs no setup, see Demo Mode). See WebServer Setup and OPC UA Setup for how to enable each on your PLC — OPC UA currently covers fewer features (no diagnostic buffer, alarms, or runtime info yet).
S7 WebServer fields:

| Setting | Description |
|---|---|
| IP Address | IP address of the PLC WebServer (e.g. 192.168.0.1). Do not include http:// or https://. |
| Username | WebServer user account name. Created in TIA Portal → Security Settings → Users and roles. |
| Password | WebServer password. Never saved to disk — required each session. |
OPC UA fields:

| Setting | Description |
|---|---|
| Endpoint URL | The PLC’s OPC UA endpoint, e.g. opc.tcp://192.168.0.1:4840. |
| Username | OPC UA user account name. Optional — leave blank to connect anonymously if your PLC allows it. May be configured separately from the WebServer login. |
| Password | OPC UA password. Never saved to disk — required each session, same as the WebServer method. |
Both methods:
| Setting | Description |
|---|---|
| Connect / Disconnect | Establishes or closes the PLC session. |
| Status dot | Green = connected, red = disconnected or error. |
TIA Portal MCP
Section titled “TIA Portal MCP”| Setting | Description |
|---|---|
| Connect / Disconnect | Starts the bundled MCP server and attaches to the running TIA Portal instance. TIA Portal V21 must be open with a project loaded. |
| Status dot | Green = server running and connected to TIA Portal. |
In development builds only, an additional field lets you specify a custom path to the MCP server executable.
Ladder Migration MCP
Section titled “Ladder Migration MCP”| Setting | Description |
|---|---|
| Connect / Disconnect | Starts the bundled Ladder Migration MCP server. |
| Status dot | Green = server running and ready. |
AI Agent tab
Section titled “AI Agent tab”Model Provider
Section titled “Model Provider”A toggle lets you choose between Anthropic, OpenAI-compatible (Ollama, OpenAI, OpenRouter, or any other endpoint that speaks the OpenAI API), and Anthropic gateway (a company gateway that speaks Anthropic’s API). See Setup & Models for a full walkthrough of each provider. Each provider keeps its own settings, so switching never overwrites another one.
Anthropic fields:

| Setting | Description |
|---|---|
| API Key | Your personal Anthropic API key. Stored encrypted on your local machine using the Windows DPAPI. Never transmitted to S7 PLC Buddy’s servers. |
| Model | The Claude model to use (Opus 5, Sonnet 5, Haiku 4.5, or a custom model ID). |
OpenAI-compatible fields:

| Setting | Description |
|---|---|
| Base URL | The API endpoint, e.g. http://localhost:11434/v1 for Ollama. Quick-fill buttons are provided for Ollama, OpenAI, and OpenRouter. |
| API Key | Optional — leave blank for a local Ollama instance, which needs no authentication. Stored encrypted, sent only to the Base URL above. |
| Max Output Tokens | Optional override for the model’s response length cap. Defaults to 4096 if left blank. |
| Model | Free-text model ID exactly as your provider expects it, e.g. llama3.1 or openai/gpt-4o-mini. |
A note appears in the app when a local endpoint is configured: tool-calling reliability varies more with local and smaller models than with Anthropic or a hosted provider.
The Base URL of this provider normally ends in /v1; the app adds /responses. A hint under the field says so.
Anthropic gateway fields:

| Setting | Description |
|---|---|
| Base URL | The address of your gateway, for example https://your-gateway.example.com. Do not add /v1; the app adds /v1/messages. |
| API Key | The key for the gateway. Stored encrypted, sent only to the Base URL. |
| Send the key as | x-api-key header (the Anthropic default) or Authorization: Bearer token, whichever the gateway expects. |
| Max Output Tokens | Optional. Left blank, the app uses 128000 (64000 for model names containing haiku). Set it to the limit of the model behind the alias if requests fail with a max_tokens error. |
| Extended thinking | Auto (on when the model name contains opus, sonnet, or fable), Always on, or Off (use it if the gateway rejects the thinking setting). |
| Model | The model name exactly as your gateway uses it. |
Workspace Folder
Section titled “Workspace Folder”| Setting | Description |
|---|---|
| Workspace Folder | The local folder the AI Agent can read from and write to, and the only place it may (also through the TIA Portal and Ladder tools). Click Browse to choose a folder. Default: ~/Documents/S7 PLC Buddy. |
System tab
Section titled “System tab”License
Section titled “License”| Element | Description |
|---|---|
| License status | Shows your current tier: Free Trial (N days remaining), Pro, or Expired. |
| Upgrade / Manage | Opens the S7 PLC Buddy website to purchase or manage your Pro license. |
| Activate License | Opens the license dialog to enter a Pro license key. |
Diagnostics
Section titled “Diagnostics”| Element | Description |
|---|---|
| Log file path | Path to the application log file: %APPDATA%\S7 PLC Buddy\logs\main.log |
| Show in Explorer | Opens the log folder in Windows Explorer — useful when sending logs to support. |

| Element | Description |
|---|---|
| Version | Current installed version (e.g. 0.3.5). |
| Updates | The state of the automatic update (“You have the latest version”, “Downloading…”, “Version X is ready…”) and a Check now button. See Updates. |
| Check for updates automatically | A switch. On by default. When off, the app never looks for updates by itself; Check now still works. |
| Documentation | An Open button that opens this documentation site in your default browser. The same link is in the left sidebar on every page. |
| Machine ID | A unique fingerprint of this machine, used by the licensing system. Click the copy icon to copy it to the clipboard. Useful if you need to contact support about a license issue. |
Where settings are stored
Section titled “Where settings are stored”All settings are stored in an SQLite database at:
%APPDATA%\S7 PLC Buddy\plc-buddy.dbSensitive values (Anthropic API key, OpenAI-compatible API key, Anthropic gateway API key, license key) are encrypted using the Windows Data Protection API before being written to the database. The PLC/OPC UA password is never written — it is held in memory only for the duration of the session.
Conversation history and messages are also stored in this database.