perkeep/doc/app-environment.md

Application Environment

Camlistore applications run with the following environment variables set:

CAMLI_API_HOST (string)

URL prefix of the Camlistore server which the app should use to make API calls. It always ends in a trailing slash. Examples:

• https://foo.org:3178/pub/
• https://foo.org/pub/
• http://192.168.0.1/
• http://192.168.0.1:1234/

CAMLI_APP_BACKEND_URL (string)

URL of the application's process, always ending in a trailing slash. That path represents the top-most path that requests will hit. The path usually matches the path as visible in the outside world when camlistored is proxying an app, but that is not guaranteed. Examples:

• https://foo.org:3178/pub/
• https://foo.org/pub/
• http://192.168.0.1/
• http://192.168.0.1:1234/

CAMLI_APP_CONFIG_URL (string)

URL containing JSON configuration for the app. The app should once, upon startup, fetch this URL (using CAMLI_AUTH) to retrieve its configuration data. The response JSON is the contents of the app's "appConfig" part of the config file.

CAMLI_AUTH (string)

Username and password (username:password) that the app should use to authenticate over HTTP basic auth with the Camlistore server. Basic auth is unencrypted, hence it should only be used with HTTPS or in a secure (local loopback) environment.