Configuration reference of the server

An Agentivity server works without any setting. This page is for the day you need to change one: limit who can call it, send telemetry to your own collector, accept larger files.

Connections to AI models and other services are not here. You manage them in the Studio: see Add, change or remove credentials.

A setting is given when the container is created, with -e. Its name is the group, two underscores, then the setting.

docker run -d --name agentivity -p 5005:5005 \n  -v agentivity-data:/app/_data \n  -e UploadCache__MaxFileSizeMb=25 \n  agentivitylabs/agentivity

To change a setting on a server that already runs, remove the container and create it again with the new -e. Your data stays in the volume. See Update Agentivity and back up your data.

The execution history is in the volume. An update that replaces the container keeps it: the screen Executions and the executions that wait for a person are still there. We tested it on the image of 2026-10-15.

Only the log files are lost when the container is removed. To keep them, add a volume on /app/_logs, or read them with docker logs agentivity.

The image sends nothing to a telemetry service. The settings of the image hold no telemetry address.

To send the logs, the traces and the measures of the server to your own collector, give its address:

docker run -d --name agentivity -p 5005:5005   -v agentivity-data:/app/_data   -e OpenTelemetry__Endpoint=https://collector.mycompany.com   agentivitylabs/agentivity

The collector must accept the OpenTelemetry protocol (OTLP). If it asks for a key, add it as OpenTelemetry__Headers__Authorization. OpenTelemetry__Protocol is HttpProtobuf by default; the other value is Grpc. The logs of a server can contain parts of what your executions handle: send them only to a place you control.

The server listens on port 5005 inside the container. To reach it on another port of your machine, change the left number of -p: -p 8080:5005 gives http://localhost:8080.

To reach it from your machine only, see Keep your server private.

You rarely need to change the port inside the container. The setting is Kestrel__Endpoints__Http__Url, with the default http://0.0.0.0:5005.

By default, a web page served from any address may call the server. Calls that do not come from a browser are always accepted.

docker run -d --name agentivity -p 5005:5005 \n  -v agentivity-data:/app/_data \n  -e Cors__AllowedOrigins__0=https://app.mydomain.com \n  agentivitylabs/agentivity

An address is written as the page shows it: the scheme, the name and the port if there is one, with nothing after. This is not a sign-in: there is none. See Who can call the API.

The server removes old runs by itself.

To read the logs without opening the files: docker logs agentivity.

The JavaScript step of a workflow runs in separate worker processes.

The time one script can take is set on the step itself, not here.

The engine slows itself down when the machine is under load.

• A login. The server has none. See Keep your server private.
• The edition. It is fixed in the image.

• The setting has no effect. Check the two underscores between the group and the setting, and that the -e comes before the name of the image.
• The Studio is empty after you changed a setting. The new container was created without -v agentivity-data:/app/_data.