diff --git a/using-with-aidbox.md b/using-with-aidbox.md new file mode 100644 index 0000000..e75514a --- /dev/null +++ b/using-with-aidbox.md @@ -0,0 +1,51 @@ +## Using with Aidbox + +### 1. Start Aidbox Server + +_You can skip this step if you already have Aidbox running._ + +You can run Aidbox in various environments: locally on your computer, on a cloud server, or on an on-premises server. If you choose to run it locally on your machine, use the following commands: + + +```bash +mkdir aidbox && cd aidbox +curl -JO https://aidbox.app/runme && docker compose up +``` + +More details on [Aidbox Documentation](https://docs.aidbox.app/getting-started) + + +**Note**: Whether running Aidbox locally, on a cloud server, or on-premises, ensure that you specify the correct URL to your Aidbox instance in the steps that follow. + +### 2. Create a Client in Aidbox + +Open Aidbox REST Console and run the following request to create a new Client: + +```http request +POST /Client +Accept: text/yaml +Content-Type: text/yaml + +id: smart-launcher-v2 +secret: eyJ0eXAiOiJKV1QiLCJhbGciOiJ +grant_types: + - basic +``` + +### 3. Start SMART Launcher + +Run docker container with the following command: + +```bash +docker run --rm \ + --name smart-launcher-v2 \ + -e FHIR_SERVER_R4="http://host.docker.internal:8080/fhir" \ + -e FHIR_SERVER_R4_BASIC_AUTH="c21hcnQtbGF1bmNoZXItdjI6ZXlKMGVYQWlPaUpLVjFRaUxDSmhiR2NpT2lK" \ + -p 8081:80 \ + ghcr.io/healthsamurai/smart-launcher-v2 +``` +where `FHIR_SERVER_R4` is the URL of the Aidbox server and `FHIR_SERVER_R4_BASIC_AUTH` is the basic auth token from the Client created in the previous step (base64 of client_id:client_secret). + +### 4. Launch SMART App + +Open SMART App Launcher web interface at http://localhost:8081 and follow the instructions on the page to launch a your SMART App.