Install on Ubuntu

This guide was written for Ubuntu 20.04, although it should work for most recent versions.

Prerequisites

First, update and upgrade the system.

sudo apt-get update
sudo apt-get upgrade
sudo reboot

sudo apt install postgresql postgresql-contrib

Start postgres

sudo pg_ctlcluster 12 main start

Start postgres client

sudo -u postgres psql

Create a "medplum" user:

CREATE USER medplum WITH PASSWORD 'medplum';

Create a "medplum" database:

CREATE DATABASE medplum;
GRANT ALL PRIVILEGES ON DATABASE medplum TO medplum;

Create a "medplum_test" database:

CREATE DATABASE medplum_test;
GRANT ALL PRIVILEGES ON DATABASE medplum_test TO medplum;

Exit psql

exit

sudo apt-get install redis-server

Open the redis config file

Uncomment the "requirepass" line and set a password

requirepass medplum

Restart redis

sudo systemctl restart redis-server

Add the Node.js v18.x Ubuntu repository:

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -

Install Node.js

sudo apt-get install nodejs

Clone the Medplum repository

git clone https://github.com/medplum/medplum.git
cd medplum

Install dependencies

npm ci

Build the server and necessary dependencies

npm run build -- --filter=@medplum/server

Update the server config at packages/server/medplum.config.json with your configuration

Run in development mode (from the packages/server directory):

npm run dev

Run in production mode (from the project root directory):

node packages/server/dist/index.js