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;
\c medplum;
CREATE EXTENSION "uuid-ossp";

Create a "medplum_test" database:

CREATE DATABASE medplum_test;
GRANT ALL PRIVILEGES ON DATABASE medplum_test TO medplum;
\c medplum_test;
CREATE EXTENSION "uuid-ossp";

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 v16.x Ubuntu repository:

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

Install NodeJS

sudo apt-get install nodejs

Clone the Medplum repository

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

Run the build script

cd medplum && ./scripts/build.sh

(This will take a while. It downloads all dependencies, performs a full build, and runs all tests.)

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