There are two ways to configure Re-Earth. One option is to place a .env file in the Re-Earth working directory. The other option is to set environment variables directly.

If you make changes to the configuration while Re-Earth is running, you will need to restart it in order to reload the configuration.

Re-Earth offers flexibility and can be combined with various configurations. Here are the main configuration options:

• Database (MongoDB): Choose one of the following:

  • MongoDB running on your local host (default).
  • Mongo Atlas.

  Note: MongoDB is a popular NoSQL database management system.

• Mode: Choose one of the following:

  • Integrated mode (default): In this mode, the front-end web application is directly delivered from the back-end application. It is easy to set up and suitable for local PCs or small environments.
  • Isolated mode: In this mode, the back-end and front-end are delivered from different environments. For example, the back-end can be run on Google Cloud Run while the front-end is delivered from Google Cloud Storage.

Note: Integrated mode combines the front-end and back-end in a single environment, while isolated mode separates them into different environments.

• Auth server: Choose one of the following:

  • Built-in (default): No additional configuration is required, but it is recommended for development purposes only. It does not have a UI to manage accounts.
  • Auth0: Auth0 is an IDaaS (Identity-as-a-Service) platform supporting OpenID Connect. It is recommended for production environments.
  • Other OpenID providers and IDaaS: Recommended for production environments.

  Note: IDaaS stands for Identity-as-a-Service, which provides identity management solutions.

Database (MongoDB)

REEARTH_DB accepts the connection string of MongoDB. The default value is mongodb://localhost.

MongoDB running on your local host

No configuration is required, but if you want to change the port,

REEARTH_DB=mongodb://localhost:20000

MongoDB Atlas

First, check the connection string of your database such as mongodb+srv://hogehoge on the Mongo Atlas admin page.

REEARTH_DB=mongodb+srv://hogehoge

Mode

Integrated mode

No configuration is required.

Isolated mode

Specify REEARTH_HOST_WEB as the URL where the front-end application is deployed.