Project-Id-Version: Trac 0.12
POT-Creation-Date: 2008-01-30 09:20+0100
PO-Revision-Date: 2010-07-19 23:05+0200
Last-Translator: Jeroen Ruigrok van der Werven <>
Language-Team: en_US <>
Plural-Forms: nplurals=2; plural=(n != 1)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Generated-By: Babel 0.9.6

Warning: Can't synchronize with repository "(default)" (Unsupported version control system "git": Can't find an appropriate component, maybe the corresponding plugin was not enabled? ). Look in the Trac log for more information.

Version 1 (modified by sebastian, 10 years ago) (diff)

Initial commit

This page describe the required steps to install phTagr on a LAMP system.


Short (and maybe incomplete) installation procedure (on Ubuntu 8.04). You can install phTagr in a system wide envirsonment (server version) or in your home directory (~/public_html). Both variants are described below.

Install required server software

phTagr runs on a LAMP. So if you dont have apache2 and so one, following procedure will install it. It installs also the other required software like ffmpeg and exiftool.

$ sudo apt-get install apache2 libapache2-mod-php5 php5-myql php5-gd mysql-server mysql-client
$ sudo apt-get install ffmpeg flvtool2 imagemagick exif php-pear
$ sudo pear update-channels
$ sudo pear install HTTP_WebDAV_Server-1.0.0RC4 Crypt_Blowfish

Now, we have to create the MySQL database

$ sudo mysql -u root
mysql> CREATE DATABASE phtagr;
mysql> GRANT ALL ON phtagr.* TO 'phtagr'@'localhost' IDENTIFIED BY 'secretpassword';
mysql> quit

phTagr at system wide environment

Your site configuration points to /var/www/cake/phtagr/webroot, mod_rewrite is enabled and you are not using suPHP.

Download cakePHP and phTagr

$ cd /var/www
$ sudo svn co cake
$ sudo chown -R `whoami` cake
$ cd cake
$ svn co phtagr
$ cd phtagr
$ sudo chown -R www-data tmp users

Edit /var/www/cake/.htaccess and change app/webroot/ to phtagr/webroot/:

<IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteRule ^$   phtagr/webroot/   [L]
    RewriteRule (.*) phtagr/webroot/$1 [L]

Now open http://localhost/cake/phtagr/setup in your browser and follow the SetupProcedure.

phTagr in user directory

Your public htdoc directory is in ~/public_html, mod_rewrite is enabled in your home directory and you are using suPHP.

Download cake and phTagr

$ cd ~/public_html
$ sudo svn co cake
$ cd cake
$ svn co phtagr
$ cd phtagr
$ sudo chown -R www-data tmp users

Adapt .htaccess

Now you have to modify some .htaccess files to run the redirection properly.

Adapt ~/public_html/cake/.htaccess to

<IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteBase /~YOURNAME/cake
    RewriteRule ^$   phtagr/webroot/   [L]
    RewriteRule (.*) phtagr/webroot/$1 [L]

Adapt ~/public_html/cake/phtagr/.htaccess to

<IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteBase /~YOURNAME/cake/phtagr
    RewriteRule ^$   webroot/   [L]
    RewriteRule (.*) webroot/$1 [L]

Adapt ~/public_html/cake/phtagr/webroot/.htaccess to

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /~YOURNAME/cake/phtagr/webroot
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(.*)$ index.php?url=$1 [QSA,L]

No suPHP

If you are not using suPHP, the directories (and all subdirecoties of ~/public_html/cake/phtagr/tmp and ~/public_html/cake/phtagr/users) must be writeable and should be owned by the apache process. Usually user www-data in Debian/Ubuntu?.

$ sudo chown -R www-data ~/public_html/cake/phtagr/tmp ~/public_html/cake/phtagr/tmp 

If you cant change the permissions of tmp and users directory in phTagr make it at least readable for the world:

cd ~/public_html/cake/phtagr
find tmp -type d -exec chmod 777 "{}" \;
find tmp -type f -exec chmod 666 "{}" \;
find users -type d -exec chmod 777 "{}" \;
find users -type f -exec chmod 666 "{}" \;

Now run http://localhost/~YOURNAME/cake/phtagr/setup for the SetupProcedure