diff options
Diffstat (limited to 'doc/vagrant.markdown')
| -rw-r--r-- | doc/vagrant.markdown | 64 |
1 files changed, 64 insertions, 0 deletions
diff --git a/doc/vagrant.markdown b/doc/vagrant.markdown new file mode 100644 index 00000000..beebb323 --- /dev/null +++ b/doc/vagrant.markdown @@ -0,0 +1,64 @@ +Run Kanboard with Vagrant +========================= + +Vagrant is used to test Kanboard in different environments. + +Several configurations are available: + +- Ubuntu 14.04 LTS with Sqlite +- Ubuntu 14.04 LTS with Mysql +- Ubuntu 14.04 LTS with Postgresql +- Debian 8 with sqlite +- Debian 7.6 with Sqlite +- Debian 6 with Sqlite +- Centos 7 with Sqlite +- Centos 6.5 with Sqlite +- Freebsd 10 with Sqlite + +The installation process is not fully automated for all VM, manual configuration can be required. + +To use those configurations, you have to install the **last version of Virtualbox and Vagrant**. + +Standard boxes can be downloaded from Vagrant: + +```bash +vagrant box add ubuntu/trusty64 +vagrant box add debian/jessie64 +vagrant box add chef/debian-7.6 +vagrant box add chef/debian-6.0.10 +vagrant box add chef/centos-7.0 +vagrant box add chef/centos-6.5 +vagrant box add freebsd/FreeBSD-10.2-STABLE +``` + +### Example with Ubuntu and Sqlite + +If you want to test Kanboard on Ubuntu with Sqlite: + +```bash +vagrant up sqlite +``` + +Run composer: + +```bash +vagrant ssh sqlite +cd /var/www/html # change the path according to the chosen distribution +sudo composer install +``` + +After the initialization, go to **http://localhost:8001/**. + +If you want to use Postgresql or Mysql, you have to configure Kanboard manually (`config.php`) and configure the database inside the virtual machine. + +Available boxes are: + +- `vagrant up sqlite` +- `vagrant up mysql` +- `vagrant up postgres` +- `vagrant up debian8` +- `vagrant up debian7` +- `vagrant up debian6` +- `vagrant up centos7` +- `vagrant up centos65` +- `vagrant up freebsd10` |