Include documentation in the application
This commit is contained in:
64
doc/vagrant.markdown
Normal file
64
doc/vagrant.markdown
Normal file
@@ -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`
|
||||
Reference in New Issue
Block a user