GitHunt
SI

simpledotorg/simple-standalone-docker

Prerequisite

The following software are required to start this system:

  • docker

Starting the standalone Simple System

To start the system, simply run the following command lines:

docker compose up --no-start
docker compose start

This should create the following containers:

  • simple-standalone-docker-postgres-1
  • simple-standalone-docker-redis-1
  • simple-standalone-docker-server-1
  • simple-standalone-docker-metabase-1

Note

This will take several minutes to initialise the system on the first run.
This is because this system initialises a lot of things during the first run, including Simple Test Data
and reporting views. Metabase also takes a few minutes to initialise.

It will be much faster in after the init is done. (Only a few seconds)

Checking the system

Logging into Simple

Simple Dashboards are exposed on port 3000 localy at the following url

During initialisation, an admin dashboard account is automatically created:

username: admin@simple.org
password: MySecretPassword1

Checking Simple API docs

Simple API documentation is embeded int he application and can be reached with the following URL

Checking the data with Metabase.

Metabase is the canonical tool to access Simple Database. This Simple Standalone System comes with a Metabase instance.

Note

User provisionning is can't be done as part of the docker initialisation with the Community Version of Metabase
so we first have to run a script to create the default user:

docker exec simple-standalone-docker-metabase-1  bash /app/metabase_init.sh

Once this is done, we can log in with the following credentials:

username: user@test.test
password: MySecretPassword1

We can then have a look at the test data with some basic queries:

select * from patients;
select * from facilities;
simpledotorg/simple-standalone-docker | GitHunt