-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
The release now works under local testing #94
- Loading branch information
Showing
2 changed files
with
31 additions
and
13 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
# Deploying magpie-backend | ||
|
||
magpie-backend is now deployed using Elixir's native release mechanism and requires at least Elixir v1.11 to run. When running the app, the following environment variables need to be provided: | ||
|
||
Mandatory: | ||
- `HOST`: The URL of the host the app is supposed to run on, e.g. "www.example.com" | ||
- `SECRET_KEY_BASE`: A random secret for the Phoenix app. A random one be generated with `phx.gen.secret` | ||
- `DATABASE_URL`: The URL to the production database. If you use Heroku, this environment variable will be automatically generated | ||
- `AUTH_USERNAME`: The auth username to access the system | ||
- `AUTH_PASSWORD`: The auth password to access the system | ||
|
||
Optional: | ||
- `PORT`: The port at which the app is available. By default 443 | ||
- `MAGPIE_PATH`: The path of the app at the host. By default `/`. Useful for when deploying the app in a multi-tenant way. | ||
- `URL_SCHEME`: Whether the app is run on `https` or `http`. By default `https` | ||
- `USE_TIMBER`: Whether to use Timber as a logging backend | ||
- `MAGPIE_NO_BASIC_AUTH`: Whether to allow accessing the app without basic name (i.e. username + pw) | ||
Note: Even with this variable set to `true`, the `AUTH_USERNAME` and `AUTH_PASSWORD` environment variables are still needed to start the app. | ||
- `TIMBER_API_KEY`: The API key for Timber | ||
- `TIMBER_SOURCE_ID`: The source ID for Timber | ||
- `REAL_URL`: Useful when the app is behind a reverse proxy and you need to actually use the URL shown to the outside by the reverse proxy, e.g. in template generation in web/templates/experiments/edit.html.eex |