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 2 (modified by sebastian, 10 years ago) (diff)

Add link of SetupProcedure and SoftwareRequirements

This page describe the required steps to install phTagr on a LAMP system. After installing all the required software phTagr must be initialized which is describe in SetupProcedure. Please check also the SoftwareRequirements.


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. See also SoftwareRequirements

$ 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