Getting Started

Installation

Process mode

# Ubuntu/Debian
sudo dpkg -i gc_gateway-*.deb

# RHEL/CentOS
sudo rpm -i gc_gateway-*.rpm

Container mode (Podman)

Install the package:

dpkg --install gc_gateway_<version>_amd64.deb

The postinstall script loads all bundled container images into system Podman storage — no network access required.

The gateway will be installed under /opt/gc_gateway.

Configure

Startup settings are in /opt/gc_gateway/gc_gateway.env (process mode) or /opt/gc_gateway/gc_gateway_container.env (container mode). Both files are preserved on upgrades.

Add at least one runtime to the configuration directory:

mkdir -p /opt/gc_gateway/config/runtimes/runtime1

Create /opt/gc_gateway/config/runtimes/runtime1/runtime.json:

{
  "runtime_name": "runtime1"
}

See the configuration documentation for the full schema.

Managing the services

The log service and service hub are grouped under gc_gateway.target and can be controlled together:

# Start the log service and service hub
systemctl start gc_gateway.target

# Stop both
systemctl stop gc_gateway.target

# Check status of the whole group
systemctl status gc_gateway.target

Runtime instances can be individually controlled using their runtime ID:

# Start a runtime instance
systemctl start gc_runtime@runtime1.service

# Stop it
systemctl stop gc_runtime@runtime1.service

# Check its status
systemctl status gc_runtime@runtime1.service

Accessing the web interface

The web interface is available at http://<host>:3002 once the gateway is running.

Upgrading

Install the new package and restart the gateway:

# Ubuntu/Debian
dpkg --install gc_gateway_<new-version>_amd64.deb

systemctl restart gc_gateway.target