Hub Server on Linux#

The Cegal Hub Server binary can be run on Linux.

Note

A Hub Server must be activated once started. This can be be done remotely using the cegalhub.exe client or by using the Hub Python client library.

../../../_images/hub_server_activate.png

System requirements#

Ubuntu, Debian and CentOS distributions have been verified.

Installation#

To run Cegal Hub Server on Linux simply copy the cegalhub Linux binary onto the distribution, modify the permissions and start the server. In this scenario we are running the server on the default port 9595 without requiring TLS.

chmod +x cegalhub
./cegalhub server --tls=false
../../../_images/hub_server_ubuntu.png

Running as service#

The binary can be run as a service under Systemd.

Running behind a reverse proxy#

You may desire to run Cegal Hub Server behind a reverse proxy.

Cegal recommend Caddy Server

Caddy provides a convenient method to obtain automatic TLS certificates from lets Encrypt for any domains that you own.

The example Caddyfile below shows how Caddy will proxy GRPC requests to a running Cegal Hub Server on port 9595 and obtain TLS certificate for hubserver.example.com. It is assumed that Cegal Hub Server is already running without TLS on port 9595. It is assumed that you own example.com and have a A record that points to Linux server with a public IP address.

../../../_images/hub_server_caddyfile.png

To start Caddy simply type the below in the same folder with the Caddyfile

caddy start