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.