Headless Installation

For Linux servers without a graphical interface, OptimaGPT can be installed using .deb packages rather than the GUI installer.

This page covers installing on headless Linux machines. If your Linux machine has a desktop environment, you can use the standard installer described in Installing OptimaGPT instead.

Download the packages

Download the appropriate .deb packages from the downloads page at www.optimagpt.com. Separate packages are available for x86-64 and ARM64. Install only the packages relevant to the role of this machine.

Package	Component	Architecture
optimagateway_<version>_amd64.deb	Gateway	x86-64
optimagateway_<version>_arm64.deb	Gateway	ARM64
optimanode_<version>_amd64.deb	Node	x86-64
optimanode_<version>_arm64.deb	Node	ARM64

A machine running only inference does not need the Gateway package, and vice versa.

Install the packages

Install using dpkg:

sudo dpkg -i optimagateway_<version>_amd64.deb
sudo dpkg -i optimanode_<version>_amd64.deb

Or using apt, which resolves any missing dependencies automatically:

sudo apt install ./optimagateway_<version>_amd64.deb
sudo apt install ./optimanode_<version>_amd64.deb

Both services are registered and started automatically after installation.

Verify the services are running

sudo systemctl status optimagateway
sudo systemctl status optimanode

Both should report active (running).

Next steps

With the services running, open a web browser on another machine and navigate to the Gateway's address to complete first-time setup. See First-Time Setup.