You can create .env to customize the VM environment. Bootstrap interactively inputs the required values with some default values.
They have default values and are asked during bootstrap.sh and saved so it's not asked again.
Machine name
NAME=awesome-name
This will rename the machine name in VirtualBox. run vagrant reload to apply when updated.
It will also set the hostname of VM
CPUS=4
MEMORY=8192
This will adjust cpus and memory, run vagrant reload to apply when updated.
EXPAND_DISK_GB=10
DOTFILES_REPO=https://github.com/kennyhyun/dotfiles.git
This will make bootstrap continue to set VM environment using this external script repo
** This has no default variable
it's not saved automatically but you can manually add by editing .env file
EXPAND_DISK_GB=10
It's using 60GB of disk image but it's dynamically allocated. It's is great in most case but when the disk space is expanded, the VM performance will be deteriorated.
This will expand the disk during bootstrap. And you will have some slowness on the VM for a while but would not be slow while using the VM afterwhile.
This should be setup before running bootstrap.
Or you can retry after removing /dummy
DOCKER_DISK_SIZE_GB=45
This creates a dedicated docker disk and mount to /var/lib/docker
This uses a Fixed size disk image for the performance, so please check the free space before setting this. There is a startup script to check empty disk partition and format to utilise as a docker disk. If you want to change the size, shutdown the VM and remove the image and delete existing, and change this and start the VM. Please note any data in the container will be gone with the previous disk image.
Please note that creating a fixed size image can take a few minutes, but maybe longer in Mac (like an hour). Please be patience.
This has no default value so it uses the dynamic sized system disk image (maximum 60GB).
If you had some data left in the system disk docker libs, you can see that by 1. stop docker, 2. unmounting /var/lib/docker, 3. start docker again. You can also delete that after unmounting if you don't need that any more.
COMPOSE_VERSION=1.29.2
Downloads docker-compose from https://github.com/docker/compose/releases/download/\${dc_version}/docker-compose-$(uname -s)-$(uname -m)
You can add shared directory by envionment variables. You will need to vagrat reload
HOST_PATHS=~/Projects,C:\ProgramData
If you use docker in the host OS and binding volumes, the source volume should be in the HOST_PATHS
If the path does not exist, it creates a blank directory and shares
If you want to set VM environment variables by the host .env file, use __VM__ prefix
__VM__VERSION=1.2.3
Will set
VERSION=1.2.3
in the VM
** __VM__ZSH_THEME will set the omz theme in the VM. Please try your favorite one
https://github.com/ohmyzsh/ohmyzsh/wiki/Themes
If you want to add some hosts entry from the host .env file, use __VMHOSTS__ prefix
__VMHOSTS__127_0_0_1=somehost
Note that underscores (_) will be replaced to ..
Will addd
127.0.0.1 somehost
to /etc/hosts in the VM
If you need multiple enrties with the same IP address, you will need some suffix to distinguish enrties
__VMHOSTS__127_0_0_1=somehost
__VMHOSTS__127_0_0_1_a=anotherhost
__VMHOSTS__127_0_0_1_t=theotherhost
Anything after 4th underscore is ignored
FONT_URLS=https://www.fontsquirrel.com/fonts/download/camingocode
PATCHED_FONT_URLS=https://github.com/tonsky/FiraCode/releases/download/5.2/Fira_Code_v5.2.zip
will download url and install those automatically.
you can use urls for ttfs or zip files separated with comma
It patches font for powerline with nerd fonts.
For already patched fonts, it can be used in PATCHED_FONT_URLS