Axel: Added the English Company Server guide and customer package link

2026-07-23T11:56:10Z

Added the English Company Server guide and customer package link

New page

A Company Server allows an organization to provide a centrally managed AI
connection for S5/S7 AI Copilot. End users do not need personal OpenAI or
Anthropic API keys.

The customer package is self-contained. The customer does not need the
internal IBHsoftec server project.

== Functions ==

The reference server:

* accepts Copilot chat requests;
* forwards requests to the configured upstream AI service;
* publishes the available model;
* authorizes individual PCs by fingerprint;
* keeps provider credentials on the server;
* can run as a Linux systemd service or Docker container.

Supported upstream services include OpenAI-compatible APIs such as Ollama,
Open WebUI, vLLM and LiteLLM.

== Download ==

[[Media:S57AI-Company-Server-Kundenpaket.zip|Download the S57AI Company Server customer package]]

The package contains the FastAPI reference server, configuration examples,
systemd service, Dockerfile and detailed README.

== Requirements ==

* Linux server or virtual machine;
* Python 3.10 or newer, or Docker;
* network access from Copilot PCs to the server;
* access from the server to the selected upstream AI service;
* HTTPS and reverse proxy recommended for production use.

== Quick start with Python ==

<pre>
python3 -m venv /opt/s57ai-company-server/venv
/opt/s57ai-company-server/venv/bin/pip install -r requirements.txt
</pre>

Copy <code>company-server.env.example</code> to a protected environment file
and configure at least:

<pre>
UPSTREAM_BASE_URL=http://127.0.0.1:11434/v1
UPSTREAM_MODEL=deepseek-coder-v2:16b
UPSTREAM_API_KEY=your-upstream-key
ALLOWED_FINGERPRINTS=FINGERPRINT-OF-APPROVED-PC
</pre>

Start the server:

<pre>
/opt/s57ai-company-server/venv/bin/uvicorn server:app --host 0.0.0.0 --port 8080
</pre>

== Quick start with Docker ==

Build and run the image from the customer package:

<pre>
docker build -t s57ai-company-server .
docker run --env-file company-server.env -p 8080:8080 s57ai-company-server
</pre>

The container runs with a non-privileged user and includes a health check.

== Configure Copilot ==

# Open S5/S7 AI Copilot.
# Select <code>Company Server</code>.
# Enter the externally reachable server URL.
# Copy the displayed fingerprint.
# Add the fingerprint to <code>ALLOWED_FINGERPRINTS</code> on the server.
# Restart the server and test a Copilot request.

Example:

<pre>
https://ai.company.example
</pre>

== API used by Copilot ==

The Company Server provides:

* <code>GET /v1/models</code> for the model list;
* <code>POST /v1/copilot/chat</code> for Copilot text requests;
* a health endpoint for monitoring.

The model list reported by the server replaces local model defaults in
Copilot.

== Production recommendations ==

* publish the service only through HTTPS;
* use nginx or another reverse proxy;
* restrict incoming network access;
* store environment files with limited permissions;
* rotate upstream API keys regularly;
* back up the configuration and fingerprint allowlist;
* monitor health, logs, storage and response times;
* never expose an unsecured Ollama or Open WebUI endpoint to the Internet.

== Troubleshooting ==

If Copilot cannot connect:

# verify the URL and port from the Copilot PC;
# check firewall and reverse-proxy rules;
# verify the approved fingerprint;
# check the Company Server log;
# test access from the Company Server to the upstream AI service;
# verify the exact upstream model name.

If the model list is empty, check <code>UPSTREAM_MODEL</code> and the upstream
model API. If a request exceeds the model context window, reduce the project
context or configure a model with a larger context size.

== Security responsibility ==

The customer operates and secures the Company Server. The organization is
responsible for upstream provider terms, network security, access control,
logging, retention and protection of PLC project data.

Further information:
[[S5/S7 AI for Windows:Copilot access to AI|Copilot access to AI]]

S5/S7 AI for Windows:Company Server - Revision history

Axel: Added the English Company Server guide and customer package link