forks/baikal
1
0
Fork 0
Code Releases Activity

nginx configuring

Browse source 
Former-commit-id: cf03726c76
This commit is contained in:
Sergei Kolzun 2012-11-09 12:26:10 +11:00
parent 59d5e0c13d
commit 767db37a25
1 changed files with 225 additions and 197 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

422
INSTALL.md
View file

@ -1,198 +1,226 @@
# INSTALLING Baïkal
This document is a part of the Baïkal project. Baïkal is an open
source lightweight CalDAV and CardDAV server released under the GNU GPL. Baïkal
is copyright (c) 2012 by Jérôme Schneider.
Baïkal homepage is http://baikal.codr.fr
This document describes the system requirements for Baïkal and the
installation routine.
# 1 - System requirements
Baïkal is based on PHP 5.3.0, and uses a SQLite3 with PHP PDO. This
document does not cover the installation of these requirements.
## 1.1 - System requirements for FTP-driven hosting
The following configuration is the minimum required:
- an hosted webserver running apache 2 and PHP 5.3.0
- PHP 5.3.0 or newer with the following extensions:
- PDO and SQLite3 or MySQL
- DOM (php-xml)
Some extensions can be optionally compiled into PHP. A list of loaded
extensions can be checked using the phpinfo() function.
- 30 MB of disk space
## 1.2 - System requirements for dedicated server hosting
The following configuration is the minimum required:
- an Apache2 web server capable of running PHP, and accessible thru a
dedicated subdomain (something like "dav.mydomainname.com")
NOTE: this document only covers sub-domain based installations. Other
installations modes are possible, though not documented (yet).
- root access to a command line on this server
NOTE: tools to create and manage users are command line only. Web-based
interfaces will be produced in the future.
- PHP 5.3.0 or newer with the following extensions:
- PDO and SQLite3 or MySQL
- DOM (php-xml)
Some extensions can be optionally compiled into PHP. A list of loaded
extensions can be checked using the phpinfo() function.
- 30 MB of disk space
# 2 - Obtaining Baïkal
To get Baïkal, navigate to the following location:
http://baikal.codr.fr/
# 3 - Installation
## 3.1 - Installing Baïkal on a FTP-driven hosting
To install Baïkal on a FTP-driven hosting:
* Download the "Baikal Flat package for FTP"
* Unzip the package on you computer
* Send the unzipped package on the remote host via FTP
* (optional) Rename the Baïkal folder to whatever you want
* Navigate to the HTTP URL where you just uploaded Baïkal
* Follow the instructions of the initialization web tool
## 3.2 - Installing Baïkal on a dedicated host
### 3.2.1 - Unpacking files
To install Baïkal on a dedicated host, download the "Baïkal package".
Unpack the source package outside of the web site root
directory on your server. The location must be accessible to the web server.
Usually, it will be something like /var/www/
# a. Enter the directory where the websites are stored
$ root:~> cd /var/www
Unpacking will produce a directory with a name like baikal-x.y.z, where x.y.z
correspond to the Baïkal version. For example, the Baïkal 0.2.0 source package
will create a directory named baikal-0.2.0
# b. Unpack the package using:
$ root:/var/www> tar xzf baikal-0.2.0.tgz
Rename the untar'd directory to the name of your baikal dedicated subdomain.
# c. Rename the directory to match your domain (good practice)
$ root:/var/www> mv baikal-0.2.0 dav.mydomain.com
# d. Enter the new Baïkal directory
$ root:/var/www> cd dav.mydomain.com
In order to grant Apache access to the files of your Baïkal installation,
you'll have to grant the user running the apache process r+w permissions on
the Baïkal files. In our example, we will suppose the linux username/usergroup
running Apache is www-data:www-data
# e. Change permissions on the files
$ root:/var/www/dav.mydomain.com> chown www-data:www-data . -Rf
### 3.2.2 - Setting up the Apache virtualhost
Baïkal must be bound to a domain/subdomain in order to run properly.
This package provides a default virtualhost configuration file for Apache 2 in
Specific/virtualhosts/baikal.apache2
To enable your host to run Baïkal, you'll have to add the Baïkal virtualhost
to your Apache environment.
In our example, we will assume that the apache2 configuration directory is:
/etc/apache2
# a. Enter the Apache2 configuration directory
$ root:/var/www> cd /etc/apache2
# b. Enter the sites-available directory
$ root:/etc/apache2> cd sites-available
# c. Symlink the Baïkal virtualhost file to this directory
$ root:/etc/apache2/sites-available> ln -s /var/www/dav.mydomain.com/Specific/virtualhosts/baikal.apache2
# d. Customize the virtualhost config file
$ root:/etc/apache2/sites-available> nano baikal.apache2
# e. In baikal.apache2, replace references to dav.mydomain.com with your own domain name
# f. Activate the new virtualhost
$ root:/etc/apache2/sites-available> cd ../sites-enabled
$ root:/etc/apache2/sites-enabled> ln -s ../sites-available/baikal.apache2
# h. Restart apache
$ root:/etc/apache2/sites-enabled> /etc/init.d/apache2 restart
### 3.2.3 - Setting up Baïkal
In a web browser, navigate to http://dav.mydomain.com and follow the instructions of the initialization web tool
# 4 - Accessing the Baïkal Web Admin
Navigate to http://dav.mydomain.com/admin/
# 5 - Connecting your CalDAV / CardDAV client to Baïkal
## 5.1 - Apple iCal (OSX):
Add a new CalDAV account:
* username: the username you just created (in our example, jerome)
* password: the password you just defined
* In server address (replace domain and username): http://dav.mydomain.com/cal.php/principals/jerome
## 5.2 - Apple Calendar (iOS):
Add a new CardDAV account:
* in Settings > Mail, Contacts, Calendar > Add an account > Other
* Select "CalDAV"
* Server: http://dav.mydomain.com/cal.php/principals/jerome
* username: the username you just created (in our example, jerome)
* password: the password you just defined
## 5.3 - Apple Address Book (OSX):
Add a new CardDAV account:
* username: the username you just created (in our example, jerome)
* password: the password you just defined
* In server address (replace domain and username): http://dav.mydomain.com/card.php/addressbooks/jerome/default
## 5.4 - Apple Contacts (iOS):
Add a new CardDAV account:
* in Settings > Mail, Contacts, Calendar > Add an account > Other
* Select "CardDAV"
* Server: dav.mydomain.com/card.php (note: no http:// nor https://, and no trailing slash)
* username: the username you just created (in our example, jerome)
* password: the password you just defined
## 5.5 - Thunderbird/Lighning:
Add a new CalDAV account:
* Navigate to "Lightning" > "New account" > "On the network" > "URL"
* paste this URL: http://yourdomain.com/cal.php/calendars/username/default
of and replace the domain name, and the username with the correct values
* When asked, provide user/password; your CalDAV account should be up and running
# 6 - You're done
You may now create new calendars, new events, new visit cards :) Enjoy.
# 7 - Troubleshooting
# INSTALLING Baïkal
This document is a part of the Baïkal project. Baïkal is an open
source lightweight CalDAV and CardDAV server released under the GNU GPL. Baïkal
is copyright (c) 2012 by Jérôme Schneider.
Baïkal homepage is http://baikal.codr.fr
This document describes the system requirements for Baïkal and the
installation routine.
# 1 - System requirements
Baïkal is based on PHP 5.3.0, and uses a SQLite3 with PHP PDO. This
document does not cover the installation of these requirements.
## 1.1 - System requirements for FTP-driven hosting
The following configuration is the minimum required:
- an hosted webserver running apache 2 and PHP 5.3.0
- PHP 5.3.0 or newer with the following extensions:
- PDO and SQLite3 or MySQL
- DOM (php-xml)
Some extensions can be optionally compiled into PHP. A list of loaded
extensions can be checked using the phpinfo() function.
- 30 MB of disk space
## 1.2 - System requirements for dedicated server hosting
The following configuration is the minimum required:
- an Apache2 web server capable of running PHP, and accessible thru a
dedicated subdomain (something like "dav.mydomainname.com")
NOTE: this document only covers sub-domain based installations. Other
installations modes are possible, though not documented (yet).
- root access to a command line on this server
NOTE: tools to create and manage users are command line only. Web-based
interfaces will be produced in the future.
- PHP 5.3.0 or newer with the following extensions:
- PDO and SQLite3 or MySQL
- DOM (php-xml)
Some extensions can be optionally compiled into PHP. A list of loaded
extensions can be checked using the phpinfo() function.
- 30 MB of disk space
# 2 - Obtaining Baïkal
To get Baïkal, navigate to the following location:
http://baikal.codr.fr/
# 3 - Installation
## 3.1 - Installing Baïkal on a FTP-driven hosting
To install Baïkal on a FTP-driven hosting:
* Download the "Baikal Flat package for FTP"
* Unzip the package on you computer
* Send the unzipped package on the remote host via FTP
* (optional) Rename the Baïkal folder to whatever you want
* Navigate to the HTTP URL where you just uploaded Baïkal
* Follow the instructions of the initialization web tool
## 3.2 - Installing Baïkal on a dedicated host
### 3.2.1 - Unpacking files
To install Baïkal on a dedicated host, download the "Baïkal package".
Unpack the source package outside of the web site root
directory on your server. The location must be accessible to the web server.
Usually, it will be something like /var/www/
# a. Enter the directory where the websites are stored
$ root:~> cd /var/www
Unpacking will produce a directory with a name like baikal-x.y.z, where x.y.z
correspond to the Baïkal version. For example, the Baïkal 0.2.0 source package
will create a directory named baikal-0.2.0
# b. Unpack the package using:
$ root:/var/www> tar xzf baikal-0.2.0.tgz
Rename the untar'd directory to the name of your baikal dedicated subdomain.
# c. Rename the directory to match your domain (good practice)
$ root:/var/www> mv baikal-0.2.0 dav.mydomain.com
# d. Enter the new Baïkal directory
$ root:/var/www> cd dav.mydomain.com
In order to grant Apache access to the files of your Baïkal installation,
you'll have to grant the user running the apache process r+w permissions on
the Baïkal files. In our example, we will suppose the linux username/usergroup
running Apache is www-data:www-data
# e. Change permissions on the files
$ root:/var/www/dav.mydomain.com> chown www-data:www-data . -Rf
### 3.2.2 - Setting up a Web Server
Baikal must be bound to a domain/subdomain in order to run properly.
This package provides default virtualhost configuration files for Apache 2 and for nginx in
Specific/virtualhosts/
To enable your host to run Baikal, you'll have to add the Baikal virtualhost
to your Web Server environment.
#### Setting up the Apache virtualhost
In our example, we will assume that the apache2 configuration directory is:
/etc/apache2
# a. Enter the Apache2 configuration directory
$ root:/var/www> cd /etc/apache2
# b. Enter the sites-available directory
$ root:/etc/apache2> cd sites-available
# c. Symlink the Baikal virtualhost file to this directory
$ root:/etc/apache2/sites-available> ln -s /var/www/dav.mydomain.com/Specific/virtualhosts/baikal.apache2
# d. Customize the virtualhost config file
$ root:/etc/apache2/sites-available> nano baikal.apache2
# e. In baikal.apache2, replace references to dav.mydomain.com with your own domain name
# f. Activate the new virtualhost
$ root:/etc/apache2/sites-available> cd ../sites-enabled
$ root:/etc/apache2/sites-enabled> ln -s ../sites-available/baikal.apache2
# h. Restart apache
$ root:/etc/apache2/sites-enabled> /etc/init.d/apache2 restart
#### Setting up the nginx virtualhost
In our example, we will assume that the nginx configuration directory is:
/etc/nginx
# a. Enter the nginx configuration directory
$ root:/var/www> cd /etc/nginx
# b. Enter the sites-available directory
$ root:/etc/nginx> cd sites-available
# c. Symlink the Baikal virtualhost file to this directory
$ root:/etc/nginx/sites-available> ln -s /var/www/dav.mydomain.com/Specific/virtualhosts/baikal.nginx
# d. Customize the virtualhost config file
$ root:/etc/nginx/sites-available> nano baikal.nginx
# e. In baikal.nginx, replace references to dav.mydomain.com with your own domain name
# f. Activate the new virtualhost
$ root:/etc/nginx/sites-available> cd ../sites-enabled
$ root:/etc/nginx/sites-enabled> ln -s ../sites-available/baikal.nginx
# h. Restart nginx
$ root:/etc/nginx/sites-enabled> /etc/init.d/nginx restart
### 3.2.3 - Setting up Baïkal
In a web browser, navigate to http://dav.mydomain.com and follow the instructions of the initialization web tool
# 4 - Accessing the Baïkal Web Admin
Navigate to http://dav.mydomain.com/admin/
# 5 - Connecting your CalDAV / CardDAV client to Baïkal
## 5.1 - Apple iCal (OSX):
Add a new CalDAV account:
* username: the username you just created (in our example, jerome)
* password: the password you just defined
* In server address (replace domain and username): http://dav.mydomain.com/cal.php/principals/jerome
## 5.2 - Apple Calendar (iOS):
Add a new CardDAV account:
* in Settings > Mail, Contacts, Calendar > Add an account > Other
* Select "CalDAV"
* Server: http://dav.mydomain.com/cal.php/principals/jerome
* username: the username you just created (in our example, jerome)
* password: the password you just defined
## 5.3 - Apple Address Book (OSX):
Add a new CardDAV account:
* username: the username you just created (in our example, jerome)
* password: the password you just defined
* In server address (replace domain and username): http://dav.mydomain.com/card.php/addressbooks/jerome/default
## 5.4 - Apple Contacts (iOS):
Add a new CardDAV account:
* in Settings > Mail, Contacts, Calendar > Add an account > Other
* Select "CardDAV"
* Server: dav.mydomain.com/card.php (note: no http:// nor https://, and no trailing slash)
* username: the username you just created (in our example, jerome)
* password: the password you just defined
## 5.5 - Thunderbird/Lighning:
Add a new CalDAV account:
* Navigate to "Lightning" > "New account" > "On the network" > "URL"
* paste this URL: http://yourdomain.com/cal.php/calendars/username/default
of and replace the domain name, and the username with the correct values
* When asked, provide user/password; your CalDAV account should be up and running
# 6 - You're done
You may now create new calendars, new events, new visit cards :) Enjoy.
# 7 - Troubleshooting
Please read TROUBLESHOOTING.md in this folder.