Build Linux VMs for Docker swarm cluster

First published: Wednesday, May 28, 2025 | Last updated: Wednesday, May 28, 2025

Build Linux VMs for Docker swarm cluster using the SloopStash Linux starter-kit.


Configure environment variables

Supported environment variables

# Allowed values for $OS_NAME variable.
* alma-linux-9

# Allowed values for $OS_ARCHITECTURE variable.
* amd64
* arm64

# Allowed values for $OS_EDITION variable.
* server

# Allowed values for $HYPERVISOR variable.
* virtualbox
* vmware

Set environment variables

# Store environment variables.
$ export OS_NAME=alma-linux-9
$ export OS_ARCHITECTURE=amd64
$ export OS_EDITION=server
$ export HYPERVISOR=virtualbox
$ export VAGRANT_CONF_DIR=./vagrant/$OS_NAME/$HYPERVISOR/$OS_ARCHITECTURE/$OS_EDITION

Build and manage Linux VMs for Docker swarm cluster using Vagrant

Windows

You can use the below commands to build, automate, and manage Linux VMs for Docker swarm cluster on the Windows operating system using Vagrant.

  1. Open the Git Bash terminal in administrator mode.
  2. Execute the below commands in the Git Bash terminal to build, automate, and manage Linux VMs for Docker swarm cluster.
# Switch to SloopStash Linux starter-kit directory.
$ cd /opt/kickstart-linux

# Boot Linux VM using Vagrant.
$ VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant up sloopstash-dkr-mgr-1
$ VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant up sloopstash-dkr-wkr-1
$ VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant up sloopstash-dkr-wkr-2

# Halt Linux VM using Vagrant.
$ VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant halt sloopstash-dkr-mgr-1
$ VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant halt sloopstash-dkr-wkr-1
$ VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant halt sloopstash-dkr-wkr-2

# SSH to Linux VM using Vagrant.
$ VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant ssh sloopstash-dkr-mgr-1
$ VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant ssh sloopstash-dkr-wkr-1
$ VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant ssh sloopstash-dkr-wkr-2

# Destroy Linux VM using Vagrant.
$ VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant destroy sloopstash-dkr-mgr-1
$ VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant destroy sloopstash-dkr-wkr-1
$ VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant destroy sloopstash-dkr-wkr-2

Mac and Linux

You can use the following commands to build, automate, and manage Linux VMs for Docker swarm cluster on a Mac or Linux operating system using Vagrant.

  1. Open the terminal.
  2. Execute the below commands in the terminal to build, automate, and manage Linux VMs for Docker swarm cluster.
# Switch to SloopStash Linux starter-kit directory.
$ cd /opt/kickstart-linux

# Boot Linux VM using Vagrant.
$ sudo VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant up sloopstash-dkr-mgr-1
$ sudo VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant up sloopstash-dkr-wkr-1
$ sudo VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant up sloopstash-dkr-wkr-2

# Halt Linux VM using Vagrant.
$ sudo VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant halt sloopstash-dkr-mgr-1
$ sudo VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant halt sloopstash-dkr-wkr-1
$ sudo VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant halt sloopstash-dkr-wkr-2

# SSH to Linux VM using Vagrant.
$ sudo VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant ssh sloopstash-dkr-mgr-1
$ sudo VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant ssh sloopstash-dkr-wkr-1
$ sudo VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant ssh sloopstash-dkr-wkr-2

# Destroy Linux VM using Vagrant.
$ sudo VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant destroy sloopstash-dkr-mgr-1
$ sudo VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant destroy sloopstash-dkr-wkr-1
$ sudo VAGRANT_CWD=$VAGRANT_CONF_DIR vagrant destroy sloopstash-dkr-wkr-2