{ "componentChunkName": "component---src-templates-blog-post-js", "path": "/docs/configuring-vm/", "result": {"data":{"site":{"siteMetadata":{"title":"Linuxdev Documentation","social":{"disqusShortName":"kennyyeoyounet"}}},"markdownRemark":{"id":"bdeda9f4-e066-5cbb-8d3e-d5bc814c0e13","excerpt":"Configuring the VM You can create .env to customize the VM environment. Bootstrap interactively inputs the required values with some default values. Interactive…","html":"

Configuring the VM

\n

You can create .env to customize the VM environment. Bootstrap interactively inputs the required values with some default values.

\n

Interactive Variables

\n

They have default values and are asked during bootstrap.sh and saved so it’s not asked again.

\n

Name

\n

Machine name

\n
NAME=awesome-name
\n

This will rename the machine name in VirtualBox. run vagrant reload to apply when updated.

\n

It will also set the hostname of VM

\n

Cpus and memory

\n
CPUS=4\nMEMORY=8192
\n

This will adjust cpus and memory, run vagrant reload to apply when updated.

\n

Vagrant Username

\n
EXPAND_DISK_GB=10
\n

Dotfiles Repo

\n
DOTFILES_REPO=https://github.com/kennyhyun/dotfiles.git
\n

This will make bootstrap continue to set VM environment using this external script repo

\n

** This has no default variable

\n

Optional Variables

\n

it’s not saved automatically but you can manually add by editing .env file

\n

Expand disk size

\n
EXPAND_DISK_GB=10
\n

It’s using 60GB of disk image but it’s dynamically allocated.\nIt’s is great in most case but when the disk space is expanded, the VM performance will be deteriorated.

\n

This will expand the disk during bootstrap.\nAnd you will have some slowness on the VM for a while but would not be slow while using the VM afterwhile.

\n

This should be setup before running bootstrap.\nOr you can retry after removing /dummy

\n

Docker lib disk

\n
DOCKER_DISK_SIZE_GB=45
\n

This creates a dedicated docker disk and mount to /var/lib/docker

\n

This uses a Fixed size disk image for the performance, so please check the free space before setting this.\nThere is a startup script to check empty disk partition and format to utilise as a docker disk.\nIf 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.

\n

Please note that creating a fixed size image can take a few minutes, but maybe longer in Mac (like an hour). Please be patience.

\n

This has no default value so it uses the dynamic sized system disk image (maximum 60GB).

\n

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.

\n

docker-compose version

\n
COMPOSE_VERSION=1.29.2
\n

Downloads docker-compose from https://github.com/docker/compose/releases/download/\\${dc_version}/docker-compose-$(uname -s)-$(uname -m)

\n

Share host directories

\n

You can add shared directory by envionment variables. You will need to vagrat reload

\n
HOST_PATHS=~/Projects,C:\\ProgramData
\n

If you use docker in the host OS and binding volumes, the source volume should be in the HOST_PATHS

\n

If the path does not exist, it creates a blank directory and shares

\n

Setting VM environment variables

\n

If you want to set VM environment variables by the host .env file, use __VM__ prefix

\n
__VM__VERSION=1.2.3
\n

Will set

\n
VERSION=1.2.3
\n

in the VM

\n

** __VM__ZSH_THEME will set the omz theme in the VM. Please try your favorite one

\n

https://github.com/ohmyzsh/ohmyzsh/wiki/Themes

\n

Setting VM hosts entries

\n

If you want to add some hosts entry from the host .env file, use __VMHOSTS__ prefix

\n
__VMHOSTS__127_0_0_1=somehost
\n

Note that underscores (_) will be replaced to ..

\n

Will addd

\n
127.0.0.1 somehost
\n

to /etc/hosts in the VM

\n

If you need multiple enrties with the same IP address, you will need some suffix to distinguish enrties

\n
__VMHOSTS__127_0_0_1=somehost\n__VMHOSTS__127_0_0_1_a=anotherhost\n__VMHOSTS__127_0_0_1_t=theotherhost
\n

Anything after 4th underscore is ignored

\n

Fonts

\n
FONT_URLS=https://www.fontsquirrel.com/fonts/download/camingocode\nPATCHED_FONT_URLS=https://github.com/tonsky/FiraCode/releases/download/5.2/Fira_Code_v5.2.zip
\n

will download url and install those automatically.

\n

you can use urls for ttfs or zip files separated with comma

\n

It patches font for powerline with nerd fonts.

\n

For already patched fonts, it can be used in PATCHED_FONT_URLS

","fields":{"slug":"/docs/configuring-vm/","language":""},"frontmatter":{"title":"Configuring VM","date":"October 15, 2021","description":null}},"previous":{"fields":{"slug":"/ko/docs/tips/"},"frontmatter":{"title":"Tips"}},"next":{"fields":{"slug":"/docs/trouble-shooting-and-advanced-usages/"},"frontmatter":{"title":"Trouble shooting and advanced usages"}}},"pageContext":{"id":"bdeda9f4-e066-5cbb-8d3e-d5bc814c0e13","previousPostId":"16173aa3-0137-5eaa-93c4-254d42a584b3","nextPostId":"3983e6bf-1b00-5cf5-ae9e-62d291660e87","language":"en","i18n":{"language":"en","languages":["en","ko","ja"],"defaultLanguage":"en","generateDefaultLanguagePage":false,"routed":false,"originalPath":"/docs/configuring-vm/","path":"/docs/configuring-vm/"}}}, "staticQueryHashes": ["2355076697","3347749741"]}