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

Update Vagrant documentation

Browse Source
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
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. Vagrant is used to test Kanboard in different environments.
Several configurations are available: Several configurations are available:
- Ubuntu 14.04 LTS with Kanboard/Sqlite - Ubuntu 14.04 LTS with Sqlite
- Ubuntu 14.04 LTS with Kanboard/Mysql - Ubuntu 14.04 LTS with Mysql
- Ubuntu 14.04 LTS with Kanboard/Postgresql - Ubuntu 14.04 LTS with Postgresql
- Debian 7.6 with Kanboard/Sqlite - 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 ```bash
vagrant box add ubuntu/trusty64 vagrant box add ubuntu/trusty64
vagrant box add chef/debian-7.6 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: If you want to test Kanboard on Ubuntu with Sqlite:
```bash ```bash
vagrant up sqlite 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```. Run composer:
After the initialization, go to http://localhost:8001/.
To test with Mysql:
```bash ```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: Available boxes are:
@@ -45,3 +55,7 @@ Available boxes are:
- `vagrant up mysql` - `vagrant up mysql`
- `vagrant up postgres` - `vagrant up postgres`
- `vagrant up debian7` - `vagrant up debian7`
- `vagrant up debian6`
- `vagrant up centos7`
- `vagrant up centos65`
- `vagrant up freebsd10`