Add using with aidbox instructions

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.