Home/ Docs/Install the gateway

Install the gateway

Deploy the ECG:Connect gateway Docker container in under 30 minutes

8 min read

Prerequisites

  • Linux server (Ubuntu 22.04 LTS recommended)
  • Docker 24.0+ and Docker Compose 2.0+
  • Network access from ECG devices (FTP or network share)
  • Outbound HTTPS access on port 443 (for cloud sync)
  • Inbound MLLP port 6661 open from HMIS (for HL7)
Minimum specs: 2 CPU cores, 4GB RAM, 50GB storage. SSD recommended for SQLite performance.

Step 1: Pull the gateway image

docker pull offinhealthcare/ecg-connect-gateway:latest

Step 2: Create your environment file

cp .env.example .env

Edit .env and set at minimum:

LICENSE_KEY=your-license-key-from-offin-cloud
HOSPITAL_NAME=Korle Bu Teaching Hospital
DROP_FOLDER=/data/drop-folder
CLOUD_API_URL=https://api.offinhealthcare.com
HL7_ENABLED=true
HL7_HOST=your-hmis-ip
HL7_PORT=6661

Step 3: Start with Docker Compose

# docker-compose.yml
version: '3.8'
services:
  gateway:
    image: offinhealthcare/ecg-connect-gateway:latest
    env_file: .env
    ports:
      - "3000:3000"   # Web dashboard
      - "6661:6661"   # HL7 MLLP
    volumes:
      - ./data:/data
      - ./logs:/app/logs
    restart: unless-stopped
docker compose up -d

Step 4: Verify the gateway is running

Open http://your-server-ip:3000 in a browser on the hospital LAN. You should see the ECG:Connect login screen.

Default admin credentials are printed to the Docker logs on first start:

docker compose logs gateway | grep "Default admin"
Change the default password immediately after first login via Settings → Change password.

Step 5: Confirm cloud connection

In the dashboard, go to Settings → Cloud Status. A green "Connected" badge confirms your license key is valid and the gateway can reach the OFFIN cloud.