A standard installation of the Gigantum client will have our recommended configuration. At present, we can provide only limited support for non-standard configurations. As such, while we provide documentation below, please realize that we can make no guarantees once you start making such changes!
Changes can be made by creating a file called
~/gigantum/.labmanager/config.yaml (this will be parsed as a YAML file). Any configuration you provide there will override the defaults.
While Gigantum only guarantees support for our official base images (these are maintained as an open source project), it is possible to configure alternative or additional sources. The default configuration is:
environment repo_url "https://github.com/gigantum/base-images.git"
You may substitute any git repository that adheres to the appropriate specification (we recommend forking our existing base-images repository to get started). The repository URL will check out the default branch (usually master), though you can specify a non-standard branch with syntax like the following:
"https://github.com/gigantum/base-images.git@experimental". While the default is to use only one repository, you may also use a list of repositories. If you wish to keep the default gigantum repositories, for example, you might add your own repository like this:
environment repo_url "https://github.com/gigantum/base-images.git" "https://github.com/my-org/my-base-images.git@experimental"
By default, the local Gigantum client will maintain your identity in the application itself. This allows you to retain your identity and work offline. If you would rather have identity managed by the browser (for example, if you are supporting multiple users on one client), you can add the following to a custom configuration file (the default for
auth client_id0Ajo8Ov6Qriafo0xVpSyejWy1pwNWdhk provider_domaingigantum.auth0.com audienceapi.gigantum.io signing_algorithmRS256 identity_managerbrowser
Currently, configuration logic overwrites the entire section, so its necessary to repeat the entire auth configuration.