# Public Test Servers

**Category:** [Platform](https://discourse.openehr.org/c/platform-implem/7)
**Created:** 2022-07-07 17:07 UTC
**Views:** 1793
**Replies:** 29
**URL:** https://discourse.openehr.org/t/public-test-servers/2812

---

## Post #1 by @Paco_Novillo

Hi all,
I am new to openEHR and I was wondering if there is any public online openEHR server that implementers can use for testing purpose. I am particularly interested in testing REST APIs. 
An online EHRBase or EHRServer would be great, so we don't have to deploy one in a local machine.
Thanks in advance

---

## Post #2 by @birger.haarbrandt

Hi @Paco_Novillo,

completely agree, this is on the to-do list for EHRbase. Though, not sure when this is gonna be available. As its  open source, maybe someone [tm] will just take the initiative, let's see. In the meantime, I think using Docker is just a minimal hurdle for devs to get started.

---

## Post #3 by @Paco_Novillo

Many thanks @birger.haarbrandt,
I will try with https://ehrbase.readthedocs.io/en/latest/03_development/04_docker_images/01_ehrbase/02_use_image/index.html#run-ehrbase-db-with-docker-compose

---

## Post #4 by @birger.haarbrandt

You can ask in the forum whenever you are stuck. We are really keen to provide a great developer experience, but we are still on the way getting there.

---

## Post #5 by @thomas.beale

[quote="Paco_Novillo, post:1, topic:2812"]
I am new to openEHR and I was wondering if there is any public online openEHR server that implementers can use for testing purpose. I am particularly interested in testing REST APIs.
An online EHRBase or EHRServer would be great, so we don’t have to deploy one in a local machine.
[/quote]

For EHRserver,  @pablo will be able to indicate what is available.

---

## Post #6 by @pablo

Hola Paco,

With EHRServer you have the SaaS option https://cloudehrserver.com/

Or using docker-compose:

Run with docker-compose:

    $ grails war
    $ cd docker-compose
    $ docker-compose up
    localhost:8080 will be Adminer (a MySQL manager)
    localhost:8888 will be Tomcat (running EHRServer)
    Change the ports and SMTP configuration in the docker-compose file

Source: https://github.com/ppazos/cabolabs-ehrserver#want-to-try-ehrserver

---

## Post #7 by @Kevin_Mayfield

I'm after definitions (I think these are templates) like the ones on https://ckm.openehr.org/

Are these available via an api. 

(I'm going to run a local copy of EHRBase and see if they are included.)

---

## Post #8 by @birger.haarbrandt

Hey @Kevin_Mayfield, 

there is currently no automated import of templates into EHRbase from CKM. In general, we should aim for some kind of package management to make this a bit more convenient.

EHRbase itself does not contain any Templates, you will need to download an OPT like https://ckm.apperta.org/ckm/templates/1051.57.279/export and use the REST API to upload into EHRbase (https://specifications.openehr.org/releases/ITS-REST/latest/definition.html#tag/ADL1.4)

---

## Post #9 by @joostholslag

Maybe GitHub ckm mirror is a little more convenient? https://github.com/openEHR/CKM-mirror/tree/master/local/templates

---

## Post #10 by @birger.haarbrandt

Indeed! Could also be combined with a Template Provider from the openEHR SDK (https://github.com/ehrbase/openEHR_SDK/blob/develop/web-template/src/main/java/org/ehrbase/openehr/sdk/webtemplate/templateprovider/FileBasedTemplateProvider.java) to load data automatically into EHRbase for testing purposes.

---

## Post #11 by @ian.mcnicoll

Hi Kevin.

You might want to have a look at these templates on the Apperta CKM most of which were specifically create to match the Interopen Care-Connect profiles

https://ckm.apperta.org/ckm/projects/1051.61.34

You need to download the ".opt" export format. These are just xml files that need to be POST to /template endpoint to register them in the CDR.

```bash
curl --location 'https://mycdrurl/rest/openehr/v1/definition/template/adl1.4' \
--header 'Content-Type: application/xml' \
--header 'Prefer: return=minimal' \
--header 'Authorization: <BASIC Auth token> \
--data-raw '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<template xmlns="http://schemas.openehr.org/v1">
    <language>
        <terminology_id>
            <value>ISO_639-1</value>
        </terminology_id>
        <code_string>en</code_string>
    </language>
    <description>
        <original_author id="name">Ian McNicoll</original_author>
     ...
```

---

## Post #12 by @Kevin_Mayfield

Thanks. 

I found that fhir-bridge has an import template function. 

It is this function to get the templates from the repo?

![image|690x289](upload://uOB3EKRGBwX8W5OqN3DSiPGYMU7.png)

---

## Post #13 by @ian.mcnicoll

Yes or you can see the raw .opt via the green OPT button to the left of the one you have highlighted.

---

## Post #14 by @Kevin_Mayfield

Does the concept table have a central definition? 
I would like to convert this into a FHIR CodeSystem - can extract from local openEHR server but ideally would like to use the master code system.
![Screenshot 2023-09-12 at 07.07.37|690x288](upload://it8hhlJsMWmX1lwYu05NeHWTLfe.png)

---

## Post #15 by @ian.mcnicoll

https://github.com/openEHR/specifications-TERM/tree/master/computable/fhir

@sebastian.iancu - is this correct?


Specifically [codesystem-subject_relationship.xml](https://github.com/openEHR/specifications-TERM/blob/master/computable/fhir/codesystem-subject_relationship.xml)

---

## Post #16 by @sebastian.iancu

Yes, that looks like the right link - it basically corresponds to https://github.com/openEHR/specifications-TERM/blob/f6fabc353040cc5e56872ae9b64653ef61ad5be7/computable/XML/en/openehr_terminology.xml#L220 and to [this section of the specs](https://specifications.openehr.org/releases/TERM/Release-3.0.0/SupportTerminology.html#_subject_relationship).
You can see the same fhir file at [latest version](https://specifications.openehr.org/fhir/codesystem-subject_relationship) or [Release-3.0.0](https://specifications.openehr.org/releases/TERM/Release-3.0.0/computable/fhir/codesystem-subject_relationship.xml).

---

## Post #17 by @emmanuel.eschmann

Hi Pablo,
I tried to access the SaaS option https://cloudehrserver.com/ you mentioned, but I got the message “This domain cloudehrserver.com has expired”.
Is cloudserver.com only temporarily unavailable?

---

## Post #18 by @pablo

[quote="pablo, post:6, topic:2812"]
cloud
[/quote]

Hi Emmanuel, we are focusing our efforts on our new CDR https://atomik.app/ and reorganizing our business model. The EHRServer SaaS won't be available for now.

Best,
Pablo.

---

## Post #19 by @emmanuel.eschmann

Hi Pablo,

Thank you very much for your answer.
I wish you great success with Atomik!

With kind regards, Emmanuel

---

## Post #21 by @linforest

[quote="birger.haarbrandt, post:2, topic:2812"]
I think using Docker is just a minimal hurdle for devs to get started.
[/quote]

Docker Hub is not available here (zh-CN).
I'm trying to build the EHRBase image locally with the source code from GitHub. However, for now, the ehrbase-postgres image still depends on  the Docker Hub. So I have to figure out how to build the pg-image  locally.

---

## Post #22 by @jake.smolka

This is not ideal. I hope EHRbase can be made more accessible soon. 
In the meantime, can you double-check that setting up the DB manually on a plain postgres instance doesn't work?
See: https://github.com/ehrbase/ehrbase?tab=readme-ov-file#1-setup-database

---

## Post #23 by @stefanspiska

you can build the postgres image via https://github.com/ehrbase/ehrbase/blob/develop/Dockerfile_postgres

with POSTGRES_VERSION=16.2 as argument

see also https://github.com/ehrbase/ehrbase/blob/develop/.github/workflows/docker-ehrbase-postgres.yml

---

## Post #24 by @linforest

Thanks Jake and Stefanspiska!

---

## Post #25 by @linforest

[quote="jake.smolka, post:22, topic:2812"]
double-check that setting up the DB manually on a plain postgres instance
[/quote]

I would try your suggestion. Thanks, Jake.

---

## Post #26 by @linforest

IMO, one of the most important reasons why HAPI FHIR is becoming increasingly popular is probably the availability of its public test server.



[quote="pablo, post:18, topic:2812"]
EHRServer SaaS won’t be available for now
[/quote]

Is EHRServer's Web UI compatible with other openEHR-based Servers such as EHRBase, just like HAPI FHIR Server's Web UI is compatible with other FHIR-based Servers?

---

## Post #27 by @pablo

Hi @linforest I just saw this by mistake, it's easier if you tag people to answer.

EHRServer is being unmaintained for a while, we are focusing on it's improved sibling Atomik https://atomik.app/

You will find it's user interface similar to EHRServer, because it's in fact the same UI, just improved and updated.

The Web Console (UI) of Atomik/EHRServer is part of the system, it's not a separate component. I guess it's possible to port it with some coding or to create a totally separated component that can be integrated with a backend via an API, though that API doesn't exist per-se and is not part of the openEHR specs. So the Web Console in Atomik/EHRServer is actually a differentiator from other implementations, that was designed on purpose with one goal in mind: having everything you need to provide an openEHR repository and be able to manage it via a web interface, all in one box. Here you can find more info https://atomik.app/documentation/web_console

By the way, about the topic of public test servers, Atomik has a public test server here https://test.atomik.app

For accessing it, please send us a message through the contact form here https://cabolabs.com/ including your name, company, what do you want to test the server and with which purpose, and we'll setup a user for you.

Best,
Pablo.

---

## Post #28 by @linforest

Hi [Pablo](https://discourse.openehr.org/u/pablo). Several years ago, I installed the EHRServer.  I was really impressed with its intuitive and Feature-rich Web UI.  

Later, I'll contact you to register a test account for the [Atomik public test server](https://test.atomik.app/).  Thanks you so much for the public test server.

---

## Post #29 by @pablo

[quote="linforest, post:28, topic:2812"]
I installed the EHRServer. I was really impressed with its intuitive and Feature-rich Web UI.
[/quote]

Initially the EHRServer was designed for training purposes. At that time, 2011-2013 I was doing a lot of openEHR education but we didn't have any practical tool to show how openEHR works, so I designed the backend and the web console so my students were able to manage openEHR data and see it from a friendly web page, without the hassle of going directly to the database to see what was happening. Also remember at that time there was no openEHR REST API, so I created our own API to make EHRServer talk with external apps. After several years of slow improvements it became more like an open source product, though it still has a lot of value for teaching and learning. I'm planning to do some improvements to it later this year, just focusing right now on Atomik.

---

## Post #30 by @birger.haarbrandt

For the ones ending up here. We now got a test server for EHRbase + some UI tooling: 

See https://discourse.openehr.org/t/ehrbase-sandbox-tools-and-testserver/5906/3 for announcement 

and https://sandkiste.ehrbase.org/ for the actual thing.

---

## Post #31 by @SteveHarris

At EHRCON24 some sample patient records were created for the connectathon.  Does anyone know where you can get a copy of those records?

Would be very useful in a test instance ...

---


**Canonical:** https://discourse.openehr.org/t/public-test-servers/2812
**Original content:** https://discourse.openehr.org/t/public-test-servers/2812