Skip to main content

AFS_AETHER_SERVER_ENDPOINT

Deep-dive reference for:

  • AFS_AETHER_SERVER_ENDPOINT

Status​

  • active

Audience​

  • production/user

Type and Default​

  • Type: URL string.
  • Default: none in bridge mode (required when bridge mode is enabled).
  • Allowed schemes: http or https.

What It Does​

Defines the bridge server endpoint Aether connects to for remote mount services.

When bridge mode is enabled, this endpoint is used to build the shared gRPC channel for lease, writeback, and changefeed clients.

Where It Applies​

  • Bridge-mode runtime only.
  • Used during remote mount orchestration channel setup.

Input Surfaces​

  • Env: AFS_AETHER_SERVER_ENDPOINT=<url>
  • Config file (aether.toml):
    • [bridge]
    • server_endpoint = "<url>"

Resolution and Validation​

Resolution order:

  1. AFS_AETHER_SERVER_ENDPOINT
  2. bridge.server_endpoint in aether.toml
  3. Error if bridge mode is enabled and neither is set

Validation:

  • Value must not be empty.
  • Must parse as URL.
  • Scheme must be http or https.

Practical Guidance​

  • Use https in production.
  • Prefer stable DNS names over ephemeral IPs when possible.
  • Keep this aligned with the bridge deployment and auth policy (token/client metadata if configured).

Examples​

  • Env:
    • AFS_AETHER_SERVER_ENDPOINT=https://grpc.aetherfs.io
  • TOML:
    • [bridge]
    • server_endpoint = "https://grpc.aetherfs.io"
  • AFS_AETHER_WORKER_ID
  • AFS_AETHER_RECONNECT_START_MS
  • AFS_AETHER_RECONNECT_MAX_MS
  • AFS_AETHER_RECONNECT_MULTIPLIER
  • AFS_AETHER_RECONNECT_JITTER_PERCENT

Primary Implementation Sources​

  • packages/aether/src/config/types/config_resolution.rs
  • packages/aether-remote/src/mount/orchestrator.rs
  • packages/aether/src/config/reload.rs
  • packages/aether/src/config/types/tests_module.rs