Quick Start
Get the full platform running with one command.
Prerequisites
- Docker + Docker Compose v2
- An Epic client ID — fhir.epic.com → My Apps (non-production)
1. Clone and configure
git clone https://github.com/AKHester-Technologies/aj-smart-fhir-platform
cd aj-smart-fhir-platform
cp .env.example .env
Edit .env — two values required:
DB_PASSWORD=your-database-password
EPIC_CLIENT_ID=your-epic-client-id
2. Start everything
docker compose up
First startup takes 60–90 seconds for HAPI FHIR to initialise.
3. Verify
./scripts/verify.sh
Expected output:
✓ HAPI metadata endpoint (200)
✓ SMART discovery proxy (200)
✓ Discovery has authorization_endpoint
✓ Auth server health (200)
✓ JWKS endpoint (200)
✓ JWKS does not expose private key
All checks passed ✓
4. Open the portal
http://localhost:9000/portal
Log in with the dev credentials (see DataInitializer), select a patient, click Launch.
What's running
| Service | URL | Description |
|---|---|---|
| HAPI FHIR | http://localhost:8080/fhir | FHIR R4 data layer |
| Auth Server | http://localhost:9000 | SMART OAuth2 + portal |
| SMART Client | http://localhost:8081 | Clinical UI |
| PostgreSQL | localhost:5432 | Auth server database |