summaryrefslogtreecommitdiff
path: root/doc/vagrant.markdown
blob: beebb3237bada48a0f752ddbf40a6bdf64ce626b (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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
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`