1
0
Fork 0
mirror of https://gitlab.com/bramw/baserow.git synced 2025-01-31 03:12:45 +00:00
bramw_baserow/deploy/vagrant/README.md

35 lines
No EOL
1.7 KiB
Markdown

# Vagrant Baserow Ubuntu Install Test
This folder contains a vagrant file and bootstrap.sh which together will start up a
local Ubuntu 18.04 virtual machine with Baserow installed and working. To do this it
extracts the bash from the install-on-ubuntu.md guide and runs it in a fresh new VM.
> WARNING: Using this vagrant setup is currently intended only for local testing and
> development.
## How to run
1. Install virtualbox - https://www.virtualbox.org/wiki/Downloads
1. Install vagrant - https://www.vagrantup.com/downloads
1. `cd tests/vagrant_ubuntu_install`
1. Install required vagrant plugins:
1. `vagrant plugin install landrush`
1. Used to setup a local dns server so you can visit Baserow using a domain
1. `vagrant plugin install vagrant-vbguest`
1. So we can mount in your local baserow repo and use that to install Baserow
1. `vagrant vbguest`
1. On Ubuntu I had to follow the instructions
in https://github.com/vagrant-landrush/landrush/blob/master/doc/Usage.adoc#visibility-on-the-host
1. Also see https://gist.github.com/neuroticnerd/30b12648a933677ad2c4 for more
landrush dns tips.
1. Change the branch found at the end of line 6 in the Vagrantfile to be the branch you
want to test.
1. `vagrant up`
1. You might need to interactively enter your password for the landrush dns plugin
to successfully add local dns entries on your host for Baserow running inside the
vm.
1. Wait a long time for everything to be provisioned
1. Once done visit [http://baserow.vagrant.test](http://baserow.vagrant.test) on your
host machine to see the Baserow running inside the vm.
1. Run `vagrant ssh` to ssh into the VM and make changes, inspect the logs, restart
services etc.