Gigantum

The Gigantum User Hub

Welcome to the Gigantum user hub. You'll find comprehensive guides and documentation to help you start working with the Gigantum platform as quickly as possible. If you get stuck, then there is help for that too.

Let's get to it!

Get Started    Changelog

Working Remotely

Tips on how to run the Gigantum Client on a remote server

For remote work, you will typically use the Gigantum CLI on a Linux system. You will also generally need to log into your remote systems using SSH (see below if you don't have ssh installed). As such, a basic level of familiarity with command-line operation will be necessary to work successfully with a self-managed remote Client.

The default Client configuration is intended for a single user at a time

While multiple users may be able to log in at the same time to a Gigantum Client instance, the application state may become corrupted by such usage, primarily because the application caches your user identity to enable offline use.

If you want to enable multiple users, then it is best to enable browser-based identity management.

In general, you only need to complete the following steps:

  1. Provision and obtain SSH access to a remote server.
  2. The Gigantum Client relies on Docker, so you have to install Docker on the remote host.
  3. Install the Gigantum CLI so you can start and stop Gigantum over SSH.

These steps are described in greater detail in the sub-pages for different scenarios:

Note that if you are comfortable on the command line, you may find it easier to work with Docker Machine to provision, start, and stop a Docker host remotely as compared to the various web consoles available for each service. If you need help with a different cloud service, please drop us a note in our Spectrum chat community!

Getting SSH on your local machine

Linux and macOS come with the SSH command-line program pre-installed, as do recent updates to windows 10. You should be able to open a terminal (PowerShell on Windows) and run ssh from the prompt.

If you have an older version of Windows (e.g., Windows 7), you can use the graphical PuTTY program and configure tunneling under Connection->SSH->Tunnels in the configuration window. The source port should be 10000 and the destination should be 127.0.0.1:10000.

Working Remotely


Tips on how to run the Gigantum Client on a remote server

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.