Installation and Deployment

The SEEDS application is designed to be deployed as a single Docker container, which runs both the frontend and the backend services.

Prerequisites

  • Docker: Ensure Docker is installed and running on your system.

Docker Deployment

Building the Image

To build the Docker image, run the following command from the project root:

docker build -t seeds-app .

Running the Container

To run the application, use the following command (ensure port 8080 is mapped):

docker run -p 8080:8080 seeds-app

Configuration

Environment Variables

The backend requires specific environment variables to function correctly, particularly for the OIDC authentication.

These variables should be passed to the Docker container at runtime or defined in a .env file (if running locally).

Environment Variables

Variable

Description

OIDC_BASE

Base URL of the IAM provider.

OIDC_REALM

The IAM realm to authenticate against.

OIDC_CLIENT_ID

The OpenID Connect Client ID.

OIDC_CLIENT_SECRET

Critically Confidential. The secret used for token exchange.

BACKEND_PORT

Port for the internal Node.js backend.

Local Development

For local development without Docker:

  1. Frontend: .. code-block:: bash

    npm install npm run dev

  2. Backend: Navigate to the backend/ directory (or root if integrated) and run: .. code-block:: bash

    node server.js

    Note: Ensure the required environment variables are set in your local shell.