Gateway Setup Guide

This section contains guides to setup Lumeo Gateways in the configuration you desire - cloud, on-prem servers or edge devices.

Overview

Lumeo Gateway can be setup on a wide variety of hardware running on your premises, in public clouds or in the Lumeo cloud. This guide describes how to set it up on your hardware.

Helpful References :
Gateway documentation
Recommended Gateway Hardware

If installing on x86 server with Nvidia GPU, before you start, ensure that your device is setup with Ubuntu 18 or later, and the latest Nvidia drivers. Verify by running nvidia-smi on a terminal prompt.

Lumeo Cloud Gateways

You can setup a Lumeo Cloud Trial Gateway or request a production Cloud Gateway by navigating to Deploy -> Gateways, and selecting Add Gateway. Once provisioned the Gateway will appear in your account.

Lumeo Gateway Installer

Interactive Install

Set up a new Gateway by running the following command on it and following the installer prompts:

bash <(wget -qO- https://link.lumeo.com/setup)

This command can also be found in Console under Gateways → Add Gateway. The installer offers you a bunch of options to optimize your installation in the interactive model. Installing the Gateway using this installer will also set it up to auto update whenever a new Gateway version is released.

Unattended Install

Gateway installer supports the following environment variables to allow for bulk, unattended installations:

Env VariableDescriptionNotes
LUMEO_APP_IDSpecify the Application ID to connect this gateway to. See API section to find your Application ID.
LUMEO_API_KEYProvide the API Key for the specific Application you want to connect this gateway to. See API section to find your API Key.
LUMEO_GATEWAY_NAMESpecify the name used for the Gateway & container
NO_PROMPTSpecify this env variable to provision a Gateway using the default settings.

Examples:
Install and provision gateway to a specific Application Id.

LUMEO_APP_ID='app_id' LUMEO_API_KEY='api_key' bash <(wget -qO- https://link.lumeo.com/setup)

To make it easy, head to Deploy -> Add Gateway to generate a gateway provisioning token and grab a prefilled installer command you can copy and run on your gateway.

Alternative Setups

Setup TypeInstructionsNotes
AWS - EC2 InstanceAWS - EC2 InstancePrefer ECS to single instance.
AWS - Elastic Container ServiceAWS - ECS
GCP - KubernetesGCP - Kubernetes
GCP - Compute InstanceGCP - Compute InstancePrefer Kubernetes to single instance.
Jetson - BalenaJetson - BalenaLumeo on Balena OS is now deprecated.
Lumeo-Ready Gateway ApplianceLumeo-Ready Gateways

Post Install

Once setup, return to the Console to see it show up in the Gateways list.

You need to ensure the Gateway is able to talk to Lumeo’s cloud services. More info in Security & Network section.