Skip to content

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.


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:

Settings, Connections: the S7 WebServer method with IP address, username, and password 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:

Settings, Connections: the OPC UA method with endpoint URL, username, and password 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.
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.

Setting Description
Connect / Disconnect Starts the bundled Ladder Migration MCP server.
Status dot Green = server running and ready.

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:

Settings, AI Agent: the Anthropic provider with API key and model selection

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:

Settings, AI Agent: the OpenAI-compatible provider with Base URL, quick-fill buttons, API key, max output tokens, and model

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:

Settings, AI Agent: the Anthropic gateway provider with Base URL, key, key header, max output tokens, extended thinking, and model

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

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

Settings, System, About: the version, the Updates row with Check now, and the automatic-check switch

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.

All settings are stored in an SQLite database at:

%APPDATA%\S7 PLC Buddy\plc-buddy.db

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