Skip to content


Can I install this on an ARM machine?

No. ARM is not supported.

Find your User ID (UID) and Group ID (GID)

Use the following commands to find out your account's user name and group info:



id `whoami`

You'll see a line like the following:

uid=XXXX(yourusername) gid=XXXX(yourgroup) groups=XXXX(yourgroup)

How to create a user account

  • Run the following commands line by line:
sudo useradd -m <username>
sudo usermod -aG sudo <username>
sudo passwd <username>
sudo chsh -s /bin/bash <username>
su <username>

Change shell of user account to bash

The generally correcct way to do this is to change the setting and run sb install shell

If you want to do this outside the saltbox context, carry on.

How to check current shell:

echo $0


echo ${SHELL}

Run this command to set bash as your shell (where <user> is replaced with your username):

sudo chsh -s /bin/bash <user>
sudo reboot

How to fix permission issues

/opt folder

  1. Stop all docker containers
docker stop $(docker ps -a -q)
  1. Change ownership of /opt. Replace user and group to match yours' (see here).
sudo chown -R user:group /opt
  1. Change permission inheritance of /opt.
sudo chmod -R ugo+X /opt
  1. Start all docker containers
docker start $(docker ps -a -q)

/mnt folder

  1. Run the mounts tag
sb install mounts