Skip to main content

Configure the agent with the Organizations service

If you've created an Organizations service to store your organizational structure, you will need to configure the Moderne agent to point to your service. This guide will walk you through how to do that.

tip

We'd actually recommend you use a file-based system for configuring your organizational structure instead of creating an Organizations service.

If you'd like to migrate from a traditional Organizations service to a file-based one, please check out our file-based structure migration guide

Variables:

Variable NameRequiredDefaultDescription
MODERNE_AGENT_ORGANIZATION_SERVICE_URLtrueThe URL of your GraphQL service that provides organization information.
MODERNE_AGENT_ORGANIZATION_SERVICE_UPDATE_INTERVAL_SECONDSfalse600Specifies how often to request your organization information.
MODERNE_AGENT_ORGANIZATION_SERVICE_SKIPSSLfalsefalseSpecifies whether or not to skip SSL validation for HTTP connections to this Organization service instance. This must be set to true if you use a self-signed SSL/TLS certificate.

Example:

docker run \
# ... Existing variables
-e MODERNE_AGENT_ORGANIZATION_SERVICE_URL=http://localhost:8091 \
-e MODERNE_AGENT_ORGANIZATION_SERVICE_UPDATE_INTERVAL_SECONDS=600 \
# ... Additional variables