CARE

https://docs.ohc.network/
Admin
CARE is an open-source, FHIR-native electronic medical records (EMR) platform designed for...
Tokens:318,377
Snippets:3,674
Trust Score:7.7
Update:3 weeks ago
Show doc for...
Tokens:
Raw
### Run automated Nix setup script

Source: https://docs.ohc.network/contributing/local-development/nix

Runs the automated setup script from the repo root for a first-time setup. The script checks that Nix is installed and flakes are enabled, creates the Python virtual environment, installs dependencies, starts services (PostgreSQL, Redis, MinIO), runs migrations, and optionally loads sample fixtures.

```bash
./scripts/nix-dev-setup.sh
```

--------------------------------

### Manual quick start with nix develop

Source: https://docs.ohc.network/contributing/local-development/nix

Manual quick start: enters the dev shell, installs Python dependencies into a .venv, starts background services, runs migrations, and launches the unified development server (Django API plus Celery worker). On later days you usually only need nix develop, then start-services (if not already running), then rundev.

```bash
nix develop

setup-dev

start-services

rundev
```

--------------------------------

### Install frontend dependencies with npm install

Source: https://docs.ohc.network/contributing/local-development/frontend

Installs the frontend dependencies from the root of the care_fe clone. This also runs the project's postinstall step, which installs platform-specific dependencies and generates HTTP headers.

```bash
npm install  
```

--------------------------------

### Install pre-commit hooks

Source: https://docs.ohc.network/contributing/local-development/backend

Installs the pre-commit hooks configured in the repository so that linters and formatters run automatically before each commit. Run once after cloning the repository.

```bash
pre-commit install
```

--------------------------------

### Set up backend bucket, URL map, HTTP proxy, and global IP

Source: https://docs.ohc.network/deployment/providers/gcp/gcs

Creates a backend bucket with CDN enabled, a URL map pointing to it, an HTTP proxy, and reserves a global IP address. Replace bracketed placeholders with actual resource names.

```bash
# Create backend bucket with CDN  
gcloud compute backend-buckets create [BACKEND_BUCKET_NAME] \  
  --gcs-bucket-name=[BUCKET_NAME] \  
  --enable-cdn  
  
# Configure URL map  
gcloud compute url-maps create [URL_MAP_NAME] \  
  --default-backend-bucket=[BACKEND_BUCKET_NAME]  
  
# Create HTTP proxy  
gcloud compute target-http-proxies create [HTTP_PROXY_NAME] \  
  --url-map=[URL_MAP_NAME]  
  
# Reserve global IP  
gcloud compute addresses create [IP_ADDRESS_NAME] --global  
```

--------------------------------

### Set Build and Run Commands for Care Backend

Source: https://docs.ohc.network/deployment/providers/digitalocean

Build and run commands for the Care Backend app on DigitalOcean App Platform. The build command installs plugins, collects static files, and compiles messages; the run command starts Gunicorn with two workers on port 9000.

```bash
python install_plugins.py && python manage.py collectstatic --noinput && python manage.py compilemessages  
```

```bash
gunicorn config.wsgi:application --workers 2 --bind :9000  
```

--------------------------------

### Install Nix with Determinate Systems installer

Source: https://docs.ohc.network/contributing/local-development/nix

Installs Nix using the Determinate Systems installer, which provides a cleaner install and hassle-free uninstallation. Run this command in a terminal on macOS or non-NixOS Linux.

```bash
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install
```

--------------------------------

### Create virtual environment and install dependencies

Source: https://docs.ohc.network/contributing/local-development/backend

Creates a virtual environment, activates it, and installs dependencies using pipenv. Requires Python 3 and pipenv.

```bash
python3 -m venv .venv  

source .venv/bin/activate  

pipenv sync --categories "packages dev-packages docs"  


```

--------------------------------

### Install Cilium CLI and Cilium CNI

Source: https://docs.ohc.network/deployment/kubernetes/cluster-setup

Install the Cilium CLI (architecture-aware) and then install Cilium itself, pointing it at the internal API name and the pod CIDR allocated by kubeadm. The k8sServiceHost value is a placeholder; use the actual internal API DNS name and ensure the matching /etc/hosts entry exists on every node.

```bash
CILIUM_CLI_VERSION=$(curl -s https://raw.githubusercontent.com/cilium/cilium-cli/main/stable.txt)  
CLI_ARCH=amd64  
if [ "$(uname -m)" = "aarch64" ]; then CLI_ARCH=arm64; fi  
curl -L --fail --remote-name-all https://github.com/cilium/cilium-cli/releases/download/${CILIUM_CLI_VERSION}/cilium-linux-${CLI_ARCH}.tar.gz{,.sha256sum}  
sha256sum --check cilium-linux-${CLI_ARCH}.tar.gz.sha256sum  
sudo tar xzvfC cilium-linux-${CLI_ARCH}.tar.gz /usr/local/bin  
rm cilium-linux-${CLI_ARCH}.tar.gz{,.sha256sum}  

cilium install \  
  --set k8sServiceHost=kube-api.internal \  
  --set k8sServicePort=6443 \  
  --set ipam.mode=kubernetes  

```
Tokens:
Raw