Skip to main content
Version: v0.16

Configuration

Accessing Configuration​

Open the Admin Panel and navigate to the main settings page. Core configuration options are available under the General tab.

Configuration View

How Configuration Works​

Conduit uses centralized configuration management:

  1. Core stores all module configurations in the Config service
  2. Modules retrieve their config on startup
  3. Changes propagate automatically when you update settings

Configuration Methods​

MethodUse Case
Admin PanelVisual interface, recommended for most users
Admin REST APIProgrammatic access, automation
Admin GraphQL APIFlexible queries for configuration

Updating Configuration​

  1. Navigate to the module's Settings tab
  2. Edit the configuration values
  3. Click Save

Configuration Edit

Changes take effect immediately.

Core Environment Variables​

Core requires certain environment variables for startup:

NameRequiredDescriptionExample
REDIS_HOSTYesRedis host addresslocalhost
REDIS_PORTYesRedis port6379
ADMIN_HTTP_PORTNoAdmin REST/GraphQL port3030
ADMIN_SOCKET_PORTNoAdmin WebSocket port3031
GRPC_PORTNogRPC server port55152
MASTER_KEYNoAdmin request authorization secretM4ST3RK3Y
GRPC_KEYNogRPC signed request protectionsomeRandomSecret

For a complete list of environment variables across all modules, see the Environment Variables Reference.

gRPC Request Protection​

Optional security feature for module intercommunication:

  • Modules sign outgoing and verify incoming gRPC calls
  • Requires setting GRPC_KEY on all instances
  • Does not encrypt requests (use network-level security)
  • Should complement, not replace, network whitelisting

To enable, set the same GRPC_KEY value on every Core and module instance.