The Gigantum Command Line Interface (CLI) is a Python-based command line tool for installing, updating, starting, and stopping Gigantum. It runs on Python 2.7 and 3.4 or higher and can be installed with
Quick Start - Install Gigantum with Pip
If you already have Docker running and can use
pip, then you can install both the CLI and Gigantum, and then start it with the following commands:
pip3 install --user gigantum gigantum install gigantum start # When stopping gigantum. gigantum stop
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 Python installed and are able to
pip install packages. Also, this page assumes that Docker is already running.
Quick Start-Python with a Virtual Environment
We recommend using a python virtual environment to run the Gigantum CLI. If you already have Docker running and can use
pip, then you can install and start the 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. Finally, we are ready to install and run the Gigantum CLI in the virtual environment using:
pip install -U gigantum gigantum install gigantum start
Once you are done using the Gigantum CLI use these commands to close Gigantum and deactivate the virtual environment:
gigantum stop deactivate
Using a terminal, you can install the CLI and the Gigantum Client in two steps, keeping in mind that the CLI must be installed first using
Just launch a Terminal and then do the following:
- Install the CLI with
pip3 install --user gigantum;
- Install Gigantum Client container with
Downloading and installing the Gigantum Client container can take a while depending on the speed of your connection. Be patient while it runs in the background after running
gigantum install or
(Optional) Virtual Environments
Updating both the CLI and the Gigantum Client can be done with the commands below:
- Update the CLI with
pip install -U --user gigantum;
- Update Gigantum Client with
You can start and stop Gigantum Client by running the following commands in a terminal:
- To start:
- To stop:
Docker Must Be Running
Docker must always be running before you start the Gigantum Client.
Starting Gigantum Client will launch a browser and send you to http://localhost:10000.
When you are finished and want to shut down Gigantum Client, just make sure to save your work before running the stop command.