summaryrefslogtreecommitdiff
path: root/docs/vagrant.markdown
blob: a1464360a496669b21047912f95c78fa7549ec75 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
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

All Vagrant environments come with Composer and PHPunit pre-installed.

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):

```bash
vagrant box add ubuntu/trusty64
vagrant box add chef/debian-7.6
```

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:

```bash
vagrant up mysql
```

You have to configure Kanboard to use Mysql or Postgresql the first time (config file and database access).

Available boxes are:

- `vagrant up sqlite`
- `vagrant up mysql`
- `vagrant up postgres`
- `vagrant up debian7`