Change minimum requirements and add FreeBSD installation guide
This commit is contained in:
parent
dd9f1d6e11
commit
4bba5be037
|
|
@ -89,6 +89,7 @@ Documentation
|
||||||
- [Installation on Ubuntu](docs/ubuntu-installation.markdown)
|
- [Installation on Ubuntu](docs/ubuntu-installation.markdown)
|
||||||
- [Installation on Debian](docs/debian-installation.markdown)
|
- [Installation on Debian](docs/debian-installation.markdown)
|
||||||
- [Installation on Centos](docs/centos-installation.markdown)
|
- [Installation on Centos](docs/centos-installation.markdown)
|
||||||
|
- [Installation on FreeBSD](docs/freebsd-installation.markdown)
|
||||||
- [Installation on Windows Server with IIS](docs/windows-iis-installation.markdown)
|
- [Installation on Windows Server with IIS](docs/windows-iis-installation.markdown)
|
||||||
- [Example with Nginx + HTTPS + SPDY + PHP-FPM](docs/nginx-ssl-php-fpm.markdown)
|
- [Example with Nginx + HTTPS + SPDY + PHP-FPM](docs/nginx-ssl-php-fpm.markdown)
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -60,10 +60,14 @@ Vagrant.configure("2") do |config|
|
||||||
m.vm.synced_folder ".", "/var/www", owner: "www-data", group: "www-data"
|
m.vm.synced_folder ".", "/var/www", owner: "www-data", group: "www-data"
|
||||||
end
|
end
|
||||||
|
|
||||||
config.vm.define "debian6" do |m|
|
config.vm.define "centos7" do |m|
|
||||||
m.vm.box = "chef/debian-6.0.10"
|
m.vm.box = "chef/centos-7.0"
|
||||||
m.vm.provision "shell", inline: $script_sqlite
|
m.vm.synced_folder ".", "/var/www/html", owner: "apache", group: "apache"
|
||||||
m.vm.synced_folder ".", "/var/www", owner: "www-data", group: "www-data"
|
end
|
||||||
|
|
||||||
|
config.vm.define "freebsd10" do |m|
|
||||||
|
m.vm.box = "chef/freebsd-10.0"
|
||||||
|
m.vm.synced_folder ".", "/usr/local/www/apache24/data", type: "rsync", owner: "www", group: "www"
|
||||||
end
|
end
|
||||||
|
|
||||||
config.vm.network :forwarded_port, guest: 80, host: 8001
|
config.vm.network :forwarded_port, guest: 80, host: 8001
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,8 @@
|
||||||
<?php
|
<?php
|
||||||
|
|
||||||
// PHP 5.3.3 minimum
|
// PHP 5.3.3 minimum
|
||||||
if (version_compare(PHP_VERSION, '5.3.3', '<')) {
|
if (version_compare(PHP_VERSION, '5.3.7', '<')) {
|
||||||
die('This software require PHP 5.3.3 minimum');
|
die('This software require PHP 5.3.7 minimum');
|
||||||
}
|
}
|
||||||
|
|
||||||
// Checks for PHP < 5.4
|
// Checks for PHP < 5.4
|
||||||
|
|
|
||||||
|
|
@ -24,6 +24,8 @@ rm kanboard-latest.zip
|
||||||
Debian 6 (Squeeze)
|
Debian 6 (Squeeze)
|
||||||
------------------
|
------------------
|
||||||
|
|
||||||
|
**Kanboard >= 1.0.10 require at least PHP 5.3.7 and Debian 6 provide PHP 5.3.3 by default**
|
||||||
|
|
||||||
Install Apache and PHP:
|
Install Apache and PHP:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|
@ -39,4 +41,4 @@ wget http://kanboard.net/kanboard-latest.zip
|
||||||
unzip kanboard-latest.zip
|
unzip kanboard-latest.zip
|
||||||
chown -R www-data:www-data kanboard/data
|
chown -R www-data:www-data kanboard/data
|
||||||
rm kanboard-latest.zip
|
rm kanboard-latest.zip
|
||||||
```
|
```
|
||||||
|
|
|
||||||
|
|
@ -2,9 +2,7 @@ How to test Kanboard with Docker?
|
||||||
=================================
|
=================================
|
||||||
|
|
||||||
Kanboard can run with [Docker](https://www.docker.com).
|
Kanboard can run with [Docker](https://www.docker.com).
|
||||||
You can use the public image or build your own image from the `Dockerfile`.
|
There is a `Dockerfile` in the repository to build your own container.
|
||||||
|
|
||||||
Actually, the Docker image is based on the master branch (development version).
|
|
||||||
|
|
||||||
Build your own Docker image
|
Build your own Docker image
|
||||||
---------------------------
|
---------------------------
|
||||||
|
|
@ -21,25 +19,6 @@ To run your image in background on the port 80:
|
||||||
docker run -d --name kanboard -p 80:80 -t youruser/kanboard:master
|
docker run -d --name kanboard -p 80:80 -t youruser/kanboard:master
|
||||||
```
|
```
|
||||||
|
|
||||||
Run the public Kanboard image
|
|
||||||
-----------------------------
|
|
||||||
|
|
||||||
This image is stored on the [Docker Hub](https://hub.docker.com).
|
|
||||||
|
|
||||||
Fetch the image on your machine:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker pull kanboard/kanboard:master
|
|
||||||
```
|
|
||||||
|
|
||||||
Run the image:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker run -d --name kanboard -p 80:80 -t kanboard/kanboard:master
|
|
||||||
```
|
|
||||||
|
|
||||||
Note: This image is not necessary up to date
|
|
||||||
|
|
||||||
Store your data on a volume
|
Store your data on a volume
|
||||||
---------------------------
|
---------------------------
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -45,13 +45,13 @@ The project [eAccelerator seems dead and not updated since 2012](https://github.
|
||||||
We recommend to switch to the last version of PHP because it's bundled with [OPcache](http://php.net/manual/en/intro.opcache.php).
|
We recommend to switch to the last version of PHP because it's bundled with [OPcache](http://php.net/manual/en/intro.opcache.php).
|
||||||
|
|
||||||
|
|
||||||
Why the minimum requirement is PHP 5.3.3 or 5.3.7?
|
Why the minimum requirement is PHP 5.3.7?
|
||||||
--------------------------------------------------
|
-----------------------------------------
|
||||||
|
|
||||||
Kanboard use the function `password_hash()` to crypt passwords but it's available only for PHP >= 5.5.
|
Kanboard use the function `password_hash()` to crypt passwords but it's available only for PHP >= 5.5.
|
||||||
|
|
||||||
However, there is a backport for [older versions of PHP](https://github.com/ircmaxell/password_compat#requirements).
|
However, there is a backport for [older versions of PHP](https://github.com/ircmaxell/password_compat#requirements).
|
||||||
This library needs to have at least PHP 5.3.7 to work correctly (with Debian Wheezy, using PHP 5.3.3 should be fine).
|
This library require at least PHP 5.3.7 to work correctly.
|
||||||
|
|
||||||
|
|
||||||
How to test Kanboard with the PHP built-in web server?
|
How to test Kanboard with the PHP built-in web server?
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,56 @@
|
||||||
|
Freebsd Installation
|
||||||
|
====================
|
||||||
|
|
||||||
|
Freebsd 10
|
||||||
|
----------
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pkg update
|
||||||
|
pkg upgrade
|
||||||
|
|
||||||
|
# Install PHP with some standard extensions
|
||||||
|
pkg install wget unzip mod_php55 \
|
||||||
|
php55-session php55-pdo_sqlite php55-pdo \
|
||||||
|
php55-openssl php55-opcache php55-mbstring \
|
||||||
|
php55-json php55-curl php55-mcrypt \
|
||||||
|
php55-zlib php55-simplexml php55-xml php55-filter \
|
||||||
|
php55-iconv php55-dom php55-ctype
|
||||||
|
```
|
||||||
|
|
||||||
|
Check if PHP is correctly installed:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ php -v
|
||||||
|
PHP 5.5.19 (cli) (built: Nov 19 2014 04:37:37)
|
||||||
|
Copyright (c) 1997-2014 The PHP Group
|
||||||
|
Zend Engine v2.5.0, Copyright (c) 1998-2014 Zend Technologies
|
||||||
|
with Zend OPcache v7.0.4-dev, Copyright (c) 1999-2014, by Zend Technologies
|
||||||
|
```
|
||||||
|
|
||||||
|
Enable Apache in your `/etc/rc.conf`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
echo apache24_enable="YES" >> /etc/rc.conf
|
||||||
|
```
|
||||||
|
|
||||||
|
Setting up PHP for Apache, just add those lines into `/usr/local/etc/apache24/Includes/php.conf`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
AddType application/x-httpd-php .php
|
||||||
|
DirectoryIndex index.php index.html
|
||||||
|
```
|
||||||
|
|
||||||
|
Then start Apache:
|
||||||
|
|
||||||
|
```
|
||||||
|
service apache24 start
|
||||||
|
```
|
||||||
|
|
||||||
|
Install Kanboard:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
wget http://kanboard.net/kanboard-latest.zip
|
||||||
|
unzip kanboard-latest.zip
|
||||||
|
chown -R www:www kanboard/data
|
||||||
|
rm kanboard-latest.zip
|
||||||
|
```
|
||||||
|
|
@ -5,9 +5,9 @@ Requirements
|
||||||
------------
|
------------
|
||||||
|
|
||||||
- Apache or Nginx
|
- Apache or Nginx
|
||||||
- PHP >= 5.3.3
|
- PHP >= 5.3.7
|
||||||
- PHP extensions required: mbstring and pdo_sqlite (don't forget to enable extensions)
|
- PHP extensions required: mbstring and pdo_sqlite (don't forget to enable extensions)
|
||||||
- A web browser with HTML5 drag and drop support
|
- A modern web browser
|
||||||
|
|
||||||
From the archive (stable version)
|
From the archive (stable version)
|
||||||
---------------------------------
|
---------------------------------
|
||||||
|
|
|
||||||
|
|
@ -8,7 +8,6 @@ Several configurations are available:
|
||||||
- Ubuntu 14.04 LTS with Kanboard/Mysql
|
- Ubuntu 14.04 LTS with Kanboard/Mysql
|
||||||
- Ubuntu 14.04 LTS with Kanboard/Postgresql
|
- Ubuntu 14.04 LTS with Kanboard/Postgresql
|
||||||
- Debian 7.6 with Kanboard/Sqlite
|
- Debian 7.6 with Kanboard/Sqlite
|
||||||
- Debian 6 with Kanboard/Sqlite
|
|
||||||
|
|
||||||
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.
|
||||||
|
|
||||||
|
|
@ -17,7 +16,6 @@ Standard boxes can be download from [VagrantCloud](https://vagrantcloud.com):
|
||||||
```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
|
|
||||||
```
|
```
|
||||||
|
|
||||||
If you want to test Kanboard on Ubuntu with Sqlite:
|
If you want to test Kanboard on Ubuntu with Sqlite:
|
||||||
|
|
@ -42,4 +40,3 @@ Available boxes are:
|
||||||
- `vagrant up mysql`
|
- `vagrant up mysql`
|
||||||
- `vagrant up postgres`
|
- `vagrant up postgres`
|
||||||
- `vagrant up debian7`
|
- `vagrant up debian7`
|
||||||
- `vagrant up debian6`
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue