This guide provides instructions for deploying Aidbox and FHIR App Portal on Kubernetes using Helm charts.

Overview

The SmartBox Helm chart allows you to deploy a complete FHIR server solution on Kubernetes, including:

  • Aidbox FHIR server
  • FHIR App Portal
  • PostgreSQL database
  • Required configurations and secrets

Prerequisites

Before you begin, ensure you have:

  • A Kubernetes cluster (version 1.19+)
  • kubectl configured to communicate with your cluster
  • helm (version 3.0+) installed
  • Aidbox license key (for production deployments)

Deployment Guide

The official Helm charts and comprehensive deployment guide are available in the Health Samurai Helm Charts repository:

Repository: https://github.com/HealthSamurai/helm-charts/tree/main/smartbox

The repository contains:

  • Helm chart manifests - Production-ready Kubernetes manifests
  • values.yaml - Configurable deployment parameters
  • README.md - Detailed installation and configuration guide
  • Examples - Sample configurations for different deployment scenarios

Quick Start

  1. 1.
    Clone the repository:
git clone https://github.com/HealthSamurai/helm-charts.git
cd helm-charts/smartbox
  1. 2.
    Review and customize the values:
# Edit values.yaml with your configuration
vim values.yaml
  1. 3.
    Install the chart:
helm install smartbox . -f values.yaml
  1. 4.
    Verify the deployment:
kubectl get pods
kubectl get services

Configuration

Refer to the SmartBox Helm Chart documentation for detailed configuration options, including:

  • Custom resource limits
  • Persistent volume configuration
  • Ingress and TLS setup
  • Environment-specific settings
  • Backup and monitoring configuration

Last updated: