Follow these instructions to install, build, and verify the web portal.
This installation requires successful prior completion of the backend system installation.
I. (Optional) Create Development Environment
Completing the steps in this section are only necessary if you intend to make changes to the source code.
-
Set up and install NodeJS version 16.15.0 or higher using the instructions at https://nodejs.org/en/download/
-
Set up the Yarn package manager:
-
Run
corepack enable
to activate Yarn. -
Run
yarn
to install dependencies. -
Run
yarn dev
to start the yarn development server.
-
II. Build Production Environment
-
Determine your URLs.
Variable Description Default value API_URL Base API URL to access endpoints. PUBLIC_PATH Path will be used to host the app. For example, to host the frontend on https://example.com/open-source/portal it should be set to ‘/open-source/portal’. / -
Build
Dockerfile
with desired variables provided as build arguments. For example,docker build . \ -t open-source-portal \ --build-arg API_URL='https://example.com' \ --build-arg PUBLIC_PATH='/portal'
The resulting Docker image runs nginx on port
80
.
If you’d prefer to build static files instead of using Docker:
- Install NodeJS version 16.15.0 or higher.
- Run
corepack enable
to activate yarn.- Run
yarn
to install dependencies.- Run
yarn build
with desired variables set using environment. For example,API_URL=https://example.com yarn build
.The resulting static files will be located in the
/build
folder and can be hosted using any web server.
III. Launch Web Portal and Create Account
As of this writing, Chrome is the only browser supported for accessing the web portal.
- Navigate to your
PUBLIC_PATH
URL. - In the Sign in dialog box that appears, click Create account.
- Follow the prompts to generate an account activation email.
- Open the email and complete the account creation and sign in process.
If you are the very first person to create an account, the system adds the
Team Admin
team role to your account settings. Because this role has advanced access privileges to the Samsung Health Stack, we recommend that your system administrator creates the first account.