AS1024
/
Kanboard-Prod
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update Vagrant documentation

This commit is contained in:
Frederic Guillot 2015-05-14 10:49:59 -04:00
parent 9e9410df24
commit 22f44ef788
1 changed files with 29 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

44
docs/vagrant.markdown
View File

@ -2,42 +2,52 @@ Run Kanboard with Vagrant
=========================
Vagrant is used to test Kanboard in different environments.
Several configurations are available:
- Ubuntu 14.04 LTS with Kanboard/Sqlite
- Ubuntu 14.04 LTS with Kanboard/Mysql
- Ubuntu 14.04 LTS with Kanboard/Postgresql
- Debian 7.6 with Kanboard/Sqlite
- Ubuntu 14.04 LTS with Sqlite
- Ubuntu 14.04 LTS with Mysql
- Ubuntu 14.04 LTS with Postgresql
- Debian 7.6 with Sqlite
- Debian 6 with Sqlite
- Centos 7 with Sqlite
- Centos 6.5 with Sqlite
- Freebsd 10 with Sqlite
All Vagrant environments come with Composer and PHPunit pre-installed.
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.
To use those configurations, you have to install the **last version of Virtualbox and Vagrant**.
Standard boxes can be download from [VagrantCloud](https://vagrantcloud.com):
Standard boxes can be downloaded from Vagrant:
```bash
vagrant box add ubuntu/trusty64
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 chef/freebsd-10.0
```
### Example with Ubuntu and Sqlite
If you want to test Kanboard on Ubuntu with Sqlite:
```bash
vagrant up sqlite
```
**NOTE:** If you downloaded the dev version from GitHub instead of the pre-packaged zip file, remember to SSH into your Vagrant environment and run ```composer install```.
After the initialization, go to http://localhost:8001/.
To test with Mysql:
Run composer:
```bash
vagrant up mysql
vagrant ssh sqlite
cd /var/www/html # change the path according to the chosen distribution
sudo composer install
```
You have to configure Kanboard to use Mysql or Postgresql the first time (config file and database access).
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:
@ -45,3 +55,7 @@ Available boxes are:
- `vagrant up mysql`
- `vagrant up postgres`
- `vagrant up debian7`
- `vagrant up debian6`
- `vagrant up centos7`
- `vagrant up centos65`
- `vagrant up freebsd10`