Set Up a Bastion Server

To create a cluster, you first need a Genvid bastion server running. You can set up and manage a bastion server using the genvid-bastion script. The following command will set up one with the minimal services required.

From your shell, run:

genvid-bastion install --bastionid mybastion --checkmodules --update-global-tfvars --loadconfig
--bastionid mybastion
A unique identifier for your bastion. It must:
  • Be between 3 and 64 characters.
  • Only contain lowercase letters, numbers, or hyphens.
  • Start with a letter.
Use this option to install new modules if none exist or update the ones already present.
Use this option to update the global Terraform variables.
Use this option to load the jobs and logs.


Due to limitations with the Windows file system directory length, system username and Bastion ID also factor into the max possible cluster name length. We’ve set a reasonably safe name length limit, but it’s technically possible for this limit to still cause issues if the user has an especially long username and/or Bastion ID.


The bastion is configured through a series of files available under ROOTDIR/bastion-services/.


This folder contains files loaded before launching the bastion job. The content is added to the key-value store, where each object describes a folder and each value is converted to a string and inserted as a key.

The folder location can be changed using GENVID_BASTION_INIT_FOLDER. For more information, see setup_jobs().