The Gigantum Command Line Interface (CLI) is a Python-based command line tool for installing, updating, starting, and stopping Gigantum. It runs on Python 3.5 or higher and can be installed with pip
.
The CLI allows you to manage the Gigantum Client from the command line rather than using Gigantum Desktop. This may be especially useful when working with a remote server.
This page assumes that you have already installed Docker (if not, see the Installing Docker section), have Python3 installed and are able to pip install
packages. Also, this page assumes that Docker is already running.
Quick Start Summary
If you already have Docker running and can use
pip
, then you can install both the CLI and Gigantum Client, and then start it with the following commands:pip3 install --user gigantum gigantum install gigantum start
Configuring a Remote Server?
If you are trying to install Gigantum Client on a remote server, there is a Quick-start Script that automates the process.
Install the CLI
While we recommend using a python virtual environment to run the Gigantum CLI, it is not required. You can install and start a virtual environment with the following steps:
sudo apt-get install python3-venv
python3 -m venv gigantum-env
source gigantum-env/bin/activate
Once finished with these steps, the virtual environment should be running. This is indicated with the name of your virtual environment showing up before your username in the terminal.
Next, we are ready to install the Gigantum CLI in the virtual environment using:
pip install -U gigantum
This will install the package and an executable gigantum
.
Install Gigantum Client
The first step when using the CLI is to install the Gigantum Client container. To do this, Docker must be running and the CLI installed. Then simply run:
gigantum install
This will download and install the Gigantum Client Docker container. This can take several minutes depending on the speed of your internet connection. Be patient while it runs in the background after running gigantum install
.
Start and Stop Gigantum Client
Docker Must Be Running
Docker must always be running before you start the Gigantum Client.
Once the Client is installed, you can start and stop Gigantum Client by running the following commands.
To Start:
gigantum start
Starting Gigantum Client will launch a browser and send you to http://localhost:10000. If this doesn't happen, you can manually open your web browser to that location. Currently Chrome and Firefox are supported, with Chrome being recommended.
To stop when done working:
gigantum stop
Note, stopping the Client will stop all Gigantum managed containers, so be sure to save your work first!
Updating Gigantum Client
If a new version of Gigantum Client is released, you'll probably want to update your server without repeating the whole installation process. To simply update the Client container, run:
gigantum update
This will print out changes in the release and ask for confirmation before updating.
Updating the CLI
The CLI is pretty stable and rarely updated. If an update does occur and you'd like to update the CLI installation, you should re-run the pip installation command with the -U
flag, indicating out of date packages should be updated:
pip install -U gigantum
Updated 10 months ago