Installation

This guide provides three ways to install Gateway:

1. Binary Installation

Choose your operating system below for specific installation instructions for Linux:

# Download the latest binary for Linux
wget https://github.com/centralmind/gateway/releases/latest/download/gateway-linux-amd64.tar.gz

# Extract the archive
tar -xzf gateway-linux-amd64.tar.gz
mv gateway-linux-amd64 gateway

# Make the binary executable
chmod +x gateway

Windows (Intel)

# Download the latest binary for Windows
Invoke-WebRequest -Uri https://github.com/centralmind/gateway/releases/latest/download/gateway-windows-amd64.zip -OutFile gateway-windows.zip

# Extract the archive
Expand-Archive -Path gateway-windows.zip -DestinationPath .

# Rename
Rename-Item -Path "gateway-windows-amd64.exe" -NewName "gateway.exe"

macOS (Intel)

# Download the latest binary for macOS (Intel)
curl -LO https://github.com/centralmind/gateway/releases/latest/download/gateway-darwin-amd64.tar.gz

# Extract the archive
tar -xzf gateway-darwin-amd64.tar.gz
mv gateway-darwin-amd64 gateway

# Make the binary executable
chmod +x gateway

macOS (Apple Silicon)

# Download the latest binary for macOS (Apple Silicon)
curl -LO https://github.com/centralmind/gateway/releases/latest/download/gateway-darwin-arm64.tar.gz

# Extract the archive
tar -xzf gateway-darwin-arm64.tar.gz
mv gateway-darwin-arm64 gateway

# Make the binary executable
chmod +x gateway

2. Docker Installation

Option A: Use the pre-built Docker image

# Pull the latest image
docker pull ghcr.io/centralmind/gateway:latest

# Run the container
docker run -p 8080:8080 ghcr.io/centralmind/gateway:latest

Option B: Build your own Docker image

# Clone the repository
git clone https://github.com/centralmind/gateway.git
cd gateway

# Build the Docker image
docker build -t gateway .

# Run your container
docker run -p 8080:8080 gateway

3. Manual Build from Source

To compile the application yourself:

# Clone the repository
git clone https://github.com/centralmind/gateway.git
cd gateway

# Install dependencies and build
go mod download
go build -o gateway

# Make the binary executable
chmod +x gateway

# Run the application
./gateway --help