Story #15528

[docs] better explain the relationship between API server, controller and nginx in install docs

Added by Peter Amstutz 4 months ago. Updated 3 months ago.

Assigned To:
Target version:
Start date:
Due date:
% Done:


Estimated time:
Story points:


Feedback from gitter:

clients will contact port 443
nginx will forward to controller (internal port), controller forwards to the Rails API server (different internal port)

perfect.. Just one comment: wht you write here should be integrated inside the documentation :-)


This is set in install-api

geo $external_client { ... }

but is actually used in install-controller:

proxy_set_header X-External-Client $external_client;

Both parts should be listed in install-controller, along with a better explanation of what it is used for and the failure mode (keep_services.accessible doesn't work) if it isn't configured correctly.


#1 Updated by Peter Amstutz 4 months ago

  • Status changed from New to In Progress

#2 Updated by Peter Amstutz 4 months ago

  • Status changed from In Progress to New
  • Description updated (diff)

#3 Updated by Peter Amstutz 3 months ago

  • Description updated (diff)

#4 Updated by Tom Morris 3 months ago

  • Target version changed from 2019-08-14 Sprint to Arvados Future Sprints
  • Tracker changed from Bug to Story

Also available in: Atom PDF