Installation

System Requirements

Installation Methods

Docker (Recommended)

# 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

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

# 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:

# 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