Skip to content

Commit

Permalink
document env variables
Browse files Browse the repository at this point in the history
  • Loading branch information
mfenner committed Jun 10, 2024
1 parent 6a8e754 commit 3664879
Show file tree
Hide file tree
Showing 3 changed files with 72 additions and 1 deletion.
44 changes: 44 additions & 0 deletions _site/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -345,6 +345,15 @@
</span>
</a>

</li>

<li class="md-nav__item">
<a href="#configuration" class="md-nav__link">
<span class="md-ellipsis">
Configuration
</span>
</a>

</li>

<li class="md-nav__item">
Expand Down Expand Up @@ -417,6 +426,15 @@
</span>
</a>

</li>

<li class="md-nav__item">
<a href="#configuration" class="md-nav__link">
<span class="md-ellipsis">
Configuration
</span>
</a>

</li>

<li class="md-nav__item">
Expand Down Expand Up @@ -470,6 +488,32 @@ <h2 id="quickstart">Quickstart</h2>
<div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>docker<span class="w"> </span>compose<span class="w"> </span>up
</span></code></pre></div>
<p>Open a web browser and navigate to <a href="https://localhost">https://localhost</a>.</p>
<h2 id="configuration">Configuration</h2>
<p>The <code>docker-compose.yml</code> file can be modified to suit your needs. The following environment variables can be set via an <code>.env</code> file in the same folder:</p>
<ul>
<li><code>INVENIO_BROKER_URL</code> - The broker URL used by InvenioRDM.</li>
<li><code>INVENIO_CELERY_BROKER_URL</code> - The Celery broker URL used by InvenioRDM.</li>
<li><code>INVENIO_CACHE_TYPE</code> - The cache type used by InvenioRDM.</li>
<li><code>INVENIO_CACHE_REDIS_URL</code> - The cache Redis URL used by InvenioRDM.</li>
<li><code>INVENIO_ACCOUNTS_SESSION_REDIS_URL</code> - The accounts session Redis URL used by InvenioRDM.</li>
<li><code>INVENIO_CELERY_RESULT_BACKEND</code> - The Celery result backend used by InvenioRDM.</li>
<li><code>INVENIO_RATELIMIT_STORAGE_URL</code> - The ratelimit storage URL used by InvenioRDM.</li>
<li><code>INVENIO_COMMUNITIES_IDENTITIES_CACHE_REDIS_URL</code> - The communities identities cache Redis URL used by InvenioRDM.</li>
<li><code>INVENIO_SEARCH_HOSTS</code> - The search hosts used by InvenioRDM.</li>
<li><code>INVENIO_SITE_UI_URL</code> - The site UI URL used by InvenioRDM.</li>
<li><code>INVENIO_SITE_API_URL</code> - The site API URL used by InvenioRDM.</li>
<li><code>INVENIO_THEME_FRONTPAGE_TITLE</code> - The frontpage title used by InvenioRDM.</li>
<li><code>INVENIO_THEME_SHOW_FRONTPAGE_INTRO_SECTION</code> - Set to <code>true</code> to show the frontpage intro section.</li>
<li><code>INVENIO_LOGGING_CONSOLE_LEVEL</code> - The logging console level used by InvenioRDM.</li>
<li><code>INVENIO_BABEL_DEFAULT_LOCALE</code> - The default locale used by InvenioRDM.</li>
<li><code>INVENIO_WSGI_PROXIES</code> - The number of proxies used by InvenioRDM.</li>
<li><code>INVENIO_SITE_UI_URL</code> - The site UI URL used by InvenioRDM.</li>
<li><code>INVENIO_SITE_API_URL</code> - The site API URL used by InvenioRDM.</li>
<li><code>INVENIO_SECRET_KEY</code> - The secret key used by InvenioRDM.</li>
<li><code>INVENIO_SQLALCHEMY_DATABASE_URI</code> - The database URI used by InvenioRDM.</li>
<li><code>INVENIO_BASE_URL</code> - The base URL used by InvenioRDM.</li>
<li><code>INVENIO_MAIL_SUPPRESS_SEND</code> - Set to <code>true</code> to suppress sending emails.</li>
</ul>
<h2 id="technology-choices">Technology Choices</h2>
<p>InvenioRDM Starter differs from the <code>Dockerfile</code> and <code>docker-compose.yml</code> generated by
the <code>invenio-cli</code> command-line tool in the following ways:</p>
Expand Down
2 changes: 1 addition & 1 deletion _site/search/search_index.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"InvenioRDM Starter","text":""},{"location":"#introduction","title":"Introduction","text":"<p>InvenioRDM is the turn-key research data management platform. Detailed documentation is available here. InvenioRDM Starter allows easy deployment and configuration of InvenioRDM. This is achieved by providing</p> <ul> <li>a prebuilt Invenio-App-RDM Docker image.</li> <li>a Docker Compose configuration file with sensible defaults.</li> </ul> <p>InvenioRDM Starter is coordinated by the InvenioRDM partner Front Matter.</p>"},{"location":"#requirements","title":"Requirements","text":"<ul> <li>Docker Desktop (Windows, macOS, Linux) or Docker Engine (Linux)</li> </ul> <p>A local installation of Python or Invenio-CLI is not required. A git client is recommended but not required.</p>"},{"location":"#quickstart","title":"Quickstart","text":"<p>Download the <code>docker-compose.yml</code> file from the InvenioRDM Starter git repository. Alternatively, clone the repository with git.</p> <pre><code>git clone https://github.com/front-matter/invenio-rdm-starter.git\n</code></pre> <pre><code>cd invenio-rdm-starter\n</code></pre> <p>Run <code>docker-compose up</code> in the same directory as the <code>docker-compose.yml</code> file.</p> <pre><code>docker compose up\n</code></pre> <p>Open a web browser and navigate to https://localhost.</p>"},{"location":"#technology-choices","title":"Technology Choices","text":"<p>InvenioRDM Starter differs from the <code>Dockerfile</code> and <code>docker-compose.yml</code> generated by the <code>invenio-cli</code> command-line tool in the following ways:</p> <ul> <li><code>invenio-cli</code> is not used.</li> <li>The <code>invenio-app-rdm</code> Docker prebuilt image provided by InvenioRDM Starter is used instead of building the image locally.</li> <li>Debian Bookworm is used as the Docker base image, instead of <code>Almalinux</code>.</li> <li>The Docker image uses <code>Python 3.12</code> and <code>Node 20</code>.</li> <li>The Docker image uses <code>gunicorn</code> as the WSGI server instead of <code>uwsgi</code>.</li> <li>Docker Compose uses <code>Caddy</code> as the reverse proxy server instead of <code>Nginx</code>. InvenioRDM Starter will run locally at <code>https://localhost</code>, and uses a self-signed certificate issued by <code>Caddy</code>.</li> <li>Docker Compose uses <code>Redis</code> as the message broker instead of <code>RabbitMQ</code></li> </ul>"}]}
{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"InvenioRDM Starter","text":""},{"location":"#introduction","title":"Introduction","text":"<p>InvenioRDM is the turn-key research data management platform. Detailed documentation is available here. InvenioRDM Starter allows easy deployment and configuration of InvenioRDM. This is achieved by providing</p> <ul> <li>a prebuilt Invenio-App-RDM Docker image.</li> <li>a Docker Compose configuration file with sensible defaults.</li> </ul> <p>InvenioRDM Starter is coordinated by the InvenioRDM partner Front Matter.</p>"},{"location":"#requirements","title":"Requirements","text":"<ul> <li>Docker Desktop (Windows, macOS, Linux) or Docker Engine (Linux)</li> </ul> <p>A local installation of Python or Invenio-CLI is not required. A git client is recommended but not required.</p>"},{"location":"#quickstart","title":"Quickstart","text":"<p>Download the <code>docker-compose.yml</code> file from the InvenioRDM Starter git repository. Alternatively, clone the repository with git.</p> <pre><code>git clone https://github.com/front-matter/invenio-rdm-starter.git\n</code></pre> <pre><code>cd invenio-rdm-starter\n</code></pre> <p>Run <code>docker-compose up</code> in the same directory as the <code>docker-compose.yml</code> file.</p> <pre><code>docker compose up\n</code></pre> <p>Open a web browser and navigate to https://localhost.</p>"},{"location":"#configuration","title":"Configuration","text":"<p>The <code>docker-compose.yml</code> file can be modified to suit your needs. The following environment variables can be set via an <code>.env</code> file in the same folder:</p> <ul> <li><code>INVENIO_BROKER_URL</code> - The broker URL used by InvenioRDM.</li> <li><code>INVENIO_CELERY_BROKER_URL</code> - The Celery broker URL used by InvenioRDM.</li> <li><code>INVENIO_CACHE_TYPE</code> - The cache type used by InvenioRDM.</li> <li><code>INVENIO_CACHE_REDIS_URL</code> - The cache Redis URL used by InvenioRDM.</li> <li><code>INVENIO_ACCOUNTS_SESSION_REDIS_URL</code> - The accounts session Redis URL used by InvenioRDM.</li> <li><code>INVENIO_CELERY_RESULT_BACKEND</code> - The Celery result backend used by InvenioRDM.</li> <li><code>INVENIO_RATELIMIT_STORAGE_URL</code> - The ratelimit storage URL used by InvenioRDM.</li> <li><code>INVENIO_COMMUNITIES_IDENTITIES_CACHE_REDIS_URL</code> - The communities identities cache Redis URL used by InvenioRDM.</li> <li><code>INVENIO_SEARCH_HOSTS</code> - The search hosts used by InvenioRDM.</li> <li><code>INVENIO_SITE_UI_URL</code> - The site UI URL used by InvenioRDM.</li> <li><code>INVENIO_SITE_API_URL</code> - The site API URL used by InvenioRDM.</li> <li><code>INVENIO_THEME_FRONTPAGE_TITLE</code> - The frontpage title used by InvenioRDM.</li> <li><code>INVENIO_THEME_SHOW_FRONTPAGE_INTRO_SECTION</code> - Set to <code>true</code> to show the frontpage intro section.</li> <li><code>INVENIO_LOGGING_CONSOLE_LEVEL</code> - The logging console level used by InvenioRDM.</li> <li><code>INVENIO_BABEL_DEFAULT_LOCALE</code> - The default locale used by InvenioRDM.</li> <li><code>INVENIO_WSGI_PROXIES</code> - The number of proxies used by InvenioRDM.</li> <li><code>INVENIO_SITE_UI_URL</code> - The site UI URL used by InvenioRDM.</li> <li><code>INVENIO_SITE_API_URL</code> - The site API URL used by InvenioRDM.</li> <li><code>INVENIO_SECRET_KEY</code> - The secret key used by InvenioRDM.</li> <li><code>INVENIO_SQLALCHEMY_DATABASE_URI</code> - The database URI used by InvenioRDM.</li> <li><code>INVENIO_BASE_URL</code> - The base URL used by InvenioRDM.</li> <li><code>INVENIO_MAIL_SUPPRESS_SEND</code> - Set to <code>true</code> to suppress sending emails.</li> </ul>"},{"location":"#technology-choices","title":"Technology Choices","text":"<p>InvenioRDM Starter differs from the <code>Dockerfile</code> and <code>docker-compose.yml</code> generated by the <code>invenio-cli</code> command-line tool in the following ways:</p> <ul> <li><code>invenio-cli</code> is not used.</li> <li>The <code>invenio-app-rdm</code> Docker prebuilt image provided by InvenioRDM Starter is used instead of building the image locally.</li> <li>Debian Bookworm is used as the Docker base image, instead of <code>Almalinux</code>.</li> <li>The Docker image uses <code>Python 3.12</code> and <code>Node 20</code>.</li> <li>The Docker image uses <code>gunicorn</code> as the WSGI server instead of <code>uwsgi</code>.</li> <li>Docker Compose uses <code>Caddy</code> as the reverse proxy server instead of <code>Nginx</code>. InvenioRDM Starter will run locally at <code>https://localhost</code>, and uses a self-signed certificate issued by <code>Caddy</code>.</li> <li>Docker Compose uses <code>Redis</code> as the message broker instead of <code>RabbitMQ</code></li> </ul>"}]}
27 changes: 27 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,33 @@ docker compose up

Open a web browser and navigate to [https://localhost](https://localhost).

## Configuration

The `docker-compose.yml` file can be modified to suit your needs. The following environment variables can be set via an `.env` file in the same folder:

* `INVENIO_BROKER_URL` - The broker URL used by InvenioRDM.
* `INVENIO_CELERY_BROKER_URL` - The Celery broker URL used by InvenioRDM.
* `INVENIO_CACHE_TYPE` - The cache type used by InvenioRDM.
* `INVENIO_CACHE_REDIS_URL` - The cache Redis URL used by InvenioRDM.
* `INVENIO_ACCOUNTS_SESSION_REDIS_URL` - The accounts session Redis URL used by InvenioRDM.
* `INVENIO_CELERY_RESULT_BACKEND` - The Celery result backend used by InvenioRDM.
* `INVENIO_RATELIMIT_STORAGE_URL` - The ratelimit storage URL used by InvenioRDM.
* `INVENIO_COMMUNITIES_IDENTITIES_CACHE_REDIS_URL` - The communities identities cache Redis URL used by InvenioRDM.
* `INVENIO_SEARCH_HOSTS` - The search hosts used by InvenioRDM.
* `INVENIO_SITE_UI_URL` - The site UI URL used by InvenioRDM.
* `INVENIO_SITE_API_URL` - The site API URL used by InvenioRDM.
* `INVENIO_THEME_FRONTPAGE_TITLE` - The frontpage title used by InvenioRDM.
* `INVENIO_THEME_SHOW_FRONTPAGE_INTRO_SECTION` - Set to `true` to show the frontpage intro section.
* `INVENIO_LOGGING_CONSOLE_LEVEL` - The logging console level used by InvenioRDM.
* `INVENIO_BABEL_DEFAULT_LOCALE` - The default locale used by InvenioRDM.
* `INVENIO_WSGI_PROXIES` - The number of proxies used by InvenioRDM.
* `INVENIO_SITE_UI_URL` - The site UI URL used by InvenioRDM.
* `INVENIO_SITE_API_URL` - The site API URL used by InvenioRDM.
* `INVENIO_SECRET_KEY` - The secret key used by InvenioRDM.
* `INVENIO_SQLALCHEMY_DATABASE_URI` - The database URI used by InvenioRDM.
* `INVENIO_BASE_URL` - The base URL used by InvenioRDM.
* `INVENIO_MAIL_SUPPRESS_SEND` - Set to `true` to suppress sending emails.

## Technology Choices

InvenioRDM Starter differs from the `Dockerfile` and `docker-compose.yml` generated by
Expand Down

0 comments on commit 3664879

Please sign in to comment.