Website/vagrant/README.md

# This Vagrant setup is still Work in Progress, though it can be used as is.

# Disroot Website Development Environment using Vagrant

If you prefer the easy way, just execute the vagrant.sh script provided. Make sure your user is in sudoers first. ⚠️ It has been tested with Debian Buster only. ⚠️

## requirements
1. vagrant 2.2.17
	for install on Debian run commands:
	```bash
	wget https://releases.hashicorp.com/vagrant/2.2.17/vagrant_2.2.17_x86_64.deb
	sudo dpkg -i vagrant_2.2.17_x86_64.deb
	sudo apt install -f
	```

2. virtualbox  

	for install on Debian Buster run command:
	```bash
	sudo echo 'deb http://download.virtualbox.org/virtualbox/debian buster contrib' > /etc/apt/sources.list.d/virtualbox.list
	wget -q https://www.virtualbox.org/download/oracle_vbox_2016.asc -O- | sudo apt-key add -
	wget -q https://www.virtualbox.org/download/oracle_vbox.asc -O- | sudo apt-key add -
	sudo apt-get update ; sudo apt-get install virtualbox-6.1
	```

3. vagrant plugins vagrant-vbguest:  
	for install on Debian run commands:
	```bash
	vagrant plugin install vagrant-vbguest
	```

4. git
	```bash
	sudo apt install git
	```

## Installation

1. Create a Disroot folder, in which you'll clone six repositories:
	```bash
	mkdir ~/Disroot
	```
2. Clone the repositories
	```bash
	cd ~/Disroot
	git clone https://git.disroot.org/Disroot/Website.git Website
	git clone https://git.disroot.org/Disroot/grav-theme-disroot.git grav-theme-disroot
	git clone https://git.disroot.org/Disroot/grav-theme-disrootblog.git grav-theme-disrootblog
	git clone https://git.disroot.org/Disroot/grav-plugin-language-selector.git grav-plugin-language-selector
	git clone https://git.disroot.org/Disroot/Disroot-Privacy-Policy.git Disroot-Privacy-Policy
	git clone https://git.disroot.org/Disroot/CHANGELOG.git Disroot-Changelog
	git clone https://git.disroot.org/Disroot/Disroot-ToS.git Disroot-ToS
	```
3. Add the local domain name for the hub to your host machine's `/etc/hosts` file.
	```bash
	sudo echo "192.168.33.12 disroot.lan" >> /etc/hosts
	```
4. Launch Vagrant to build the virtual machine (VM). This will take several minutes.
	```bash
	cd ~/Disroot/Website/vagrant
	vagrant up disroot_lan
	```

Congratulations, you should now have a fully functioning apache+GRAV server running locally in a Virtualbox-hosted VM managed by Vagrant. Next time you want to run vagrant simply run command
	```bash
	cd ~/Disroot/Website/vagrant
	vagrant up disroot_lan
	vagrant provision
	```

### Enable SSH access

To make your development workflow more efficient, you may wish to use an SSH connection to rapidly synchronize the files you are developing in your local (host machine) development environment.

1. On your host machine, copy your public key.
	```bash
	user@host:~$ cat ~/.ssh/id_rsa.public
		ssh-rsa eLX1UQbJHUCHf2V3K7YlMP0YmIT+50rlEsWre1eobApKb0Ac/WbvssX/Gh/ user@host
	```
2. Use `vagrant ssh disroot_lan` to log in to the virtual machine.
	```bash
	user@host:~$ cd ~/Disroot/Website/vagrant
	user@host:hubzilla-vagrant$ vagrant ssh disroot_lan
	```
3. Switch to root and add your host user public key.
	```bash
	vagrant@stretch:~$ sudo -i
	root@jessie:~# ssh-keygen
			Generating public/private rsa key pair.
			Enter file in which to save the key (/root/.ssh/id_rsa):
			Created directory '/root/.ssh'.
			Enter passphrase (empty for no passphrase):
			Enter same passphrase again:
			Your identification has been saved in /root/.ssh/id_rsa.
			Your public key has been saved in /root/.ssh/id_rsa.pub.
			The key fingerprint is:
			b4:e3:00:40:4f:c5:af:27:05:09:d4:70:29:ac:f8:51 root@jessie
			The key's randomart image is:
			+---[RSA 2048]----+
			| .oo=*oo         |
			|   +E.*          |
			| . oo. o.        |
			|. o  . .o.       |
			| . .  .oS        |
			|  .   oo..       |
			|       o.        |
			|                 |
			|                 |
			+-----------------+
	root@stretch:~# echo "ssh-rsa eLX1UQbJHUCHf2V3K7YlMP0YmIT+50rlEsWre1eobApKb0Ac/WbvssX/Gh/ user@host" >> ~/.ssh/authorized_keys
	```
4. From your host machine, you may now SSH into the virtual machine using
	```bash
	ssh root@disroot.lan
	```