Installation

Complete installation guide for FabConnect Gateway.

System Requirements

OS: Linux (Ubuntu 20.04+), Windows Server 2019+, macOS 12+
CPU: 2+ cores
RAM: 4GB minimum, 8GB recommended
Storage: 20GB minimum
Network: Access to equipment subnet

Installation Methods

Docker (Recommended)

bash

# Pull the latest image
docker pull fabconnect/gateway:latest

# Create a data directory
mkdir -p /opt/fabconnect/data

# Run with persistent storage
docker run -d \
  --name fabconnect-gateway \
  --restart unless-stopped \
  -p 8080:8080 \
  -p 5000-5100:5000-5100 \
  -v /opt/fabconnect/data:/data \
  fabconnect/gateway:latest

Docker Compose

yaml

version: "3.8"
services:
  gateway:
    image: fabconnect/gateway:latest
    ports:
      - "8080:8080"
      - "5000-5100:5000-5100"
    volumes:
      - fabconnect-data:/data
    environment:
      - DATABASE_URL=postgres://user:pass@db:5432/fabconnect
    restart: unless-stopped

volumes:
  fabconnect-data:

Binary Installation

bash

# Download the binary
curl -L https://releases.fabconnect.io/latest/fabconnect-linux-amd64 -o fabconnect
chmod +x fabconnect

# Run the gateway
./fabconnect serve

Configuration

FabConnect can be configured via environment variables or a config file:

yaml

# config.yaml
server:
  port: 8080
  host: 0.0.0.0

database:
  driver: postgres
  url: postgres://localhost:5432/fabconnect

hsms:
  port_range_start: 5000
  port_range_end: 5100