A Vagrantfile is avalable into virtualization/vagrant folder for quickly spinning up a Linux virtual machine running Home Assistant. This can be beneficial for those who want to experiment with Home Assistant and/or developers willing to easily test local changes and run test suite against them.
A Vagrantfile is available into virtualization/vagrant folder for quickly spinning up a Linux virtual machine running Home Assistant. This can be beneficial for those who want to experiment with Home Assistant and/or developers willing to easily test local changes and run test suite against them.
Vagrant is intended for testing/development only. It is NOT recommended for permanent installations. @@ -101,25 +101,25 @@ Vagrant is intended for testing/development only. It is NOT recommended for perm
Download the home-assistant source code by either downloading the .zip file from GitHub releases page, or by using Git
+Download the Home Assistant source code by either downloading the .zip file from GitHub releases page or by using Git
git clone https://github.com/home-assistant/home-assistant.git -cd home-assistant/virtualization/vagrant +$ git clone https://github.com/home-assistant/home-assistant.git +$ cd home-assistant/virtualization/vagrant
-The following instructions will assume you changed your working directory to be home-assistant/virtualization/vagrant. This is mandatory because Vagrant will look for informations about the running VM inside that folder and won’t work otherwise
+The following instructions will assume you changed your working directory to be home-assistant/virtualization/vagrant. This is mandatory because Vagrant will look for informations about the running VM inside that folder and won’t work otherwise
-When using Vagrant on Windows, change git’s auto.crlf to input before cloning the Home Assistant repository. With input setting git won’t automatically change line endings from Unix LF to Windows CRLF. Shell scripts executed during provision won’t work with Windows line endings.
+When using Vagrant on Windows, change git’s auto.crlf to input before cloning the Home Assistant repository. With input setting git won’t automatically change line endings from Unix LF to Windows CRLF. Shell scripts executed during provision won’t work with Windows line endings.
git config --global core.autocrlf input +$ git config --global core.autocrlf input
vagrant up +$ vagrant up
To shutdown the Vagrant host:
vagrant halt +$ vagrant halt
Any changes made to the local directory on your workstation will be available from the Vagrant host, so to apply your changes to the Home Assistant process, just restart it:
touch restart ; vagrant provision +$ touch restart ; vagrant provision
To run tests against your changes:
touch run_tests ; vagrant provision +$ touch run_tests ; vagrant provision
To completely remove the VM:
rm setup_done ; vagrant destroy -f +$ rm setup_done ; vagrant destroy -f