Change minimum requirements and add FreeBSD installation guide

This commit is contained in:
Frédéric Guillot 2014-11-29 21:28:58 -05:00
parent dd9f1d6e11
commit 4bba5be037
9 changed files with 76 additions and 37 deletions

View File

@ -89,6 +89,7 @@ Documentation
- [Installation on Ubuntu](docs/ubuntu-installation.markdown)
- [Installation on Debian](docs/debian-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)
- [Example with Nginx + HTTPS + SPDY + PHP-FPM](docs/nginx-ssl-php-fpm.markdown)

12
Vagrantfile vendored
View File

@ -60,10 +60,14 @@ Vagrant.configure("2") do |config|
m.vm.synced_folder ".", "/var/www", owner: "www-data", group: "www-data"
end
config.vm.define "debian6" do |m|
m.vm.box = "chef/debian-6.0.10"
m.vm.provision "shell", inline: $script_sqlite
m.vm.synced_folder ".", "/var/www", owner: "www-data", group: "www-data"
config.vm.define "centos7" do |m|
m.vm.box = "chef/centos-7.0"
m.vm.synced_folder ".", "/var/www/html", owner: "apache", group: "apache"
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
config.vm.network :forwarded_port, guest: 80, host: 8001

View File

@ -1,8 +1,8 @@
<?php
// PHP 5.3.3 minimum
if (version_compare(PHP_VERSION, '5.3.3', '<')) {
die('This software require PHP 5.3.3 minimum');
if (version_compare(PHP_VERSION, '5.3.7', '<')) {
die('This software require PHP 5.3.7 minimum');
}
// Checks for PHP < 5.4

View File

@ -24,6 +24,8 @@ rm kanboard-latest.zip
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:
```bash
@ -39,4 +41,4 @@ wget http://kanboard.net/kanboard-latest.zip
unzip kanboard-latest.zip
chown -R www-data:www-data kanboard/data
rm kanboard-latest.zip
```
```

View File

@ -2,9 +2,7 @@ How to test Kanboard with Docker?
=================================
Kanboard can run with [Docker](https://www.docker.com).
You can use the public image or build your own image from the `Dockerfile`.
Actually, the Docker image is based on the master branch (development version).
There is a `Dockerfile` in the repository to build your own container.
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
```
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
---------------------------

View File

@ -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).
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.
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?

View File

@ -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
```

View File

@ -5,9 +5,9 @@ Requirements
------------
- Apache or Nginx
- PHP >= 5.3.3
- PHP >= 5.3.7
- 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)
---------------------------------

View File

@ -8,7 +8,6 @@ Several configurations are available:
- Ubuntu 14.04 LTS with Kanboard/Mysql
- Ubuntu 14.04 LTS with Kanboard/Postgresql
- 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.
@ -17,7 +16,6 @@ Standard boxes can be download from [VagrantCloud](https://vagrantcloud.com):
```bash
vagrant box add ubuntu/trusty64
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:
@ -42,4 +40,3 @@ Available boxes are:
- `vagrant up mysql`
- `vagrant up postgres`
- `vagrant up debian7`
- `vagrant up debian6`