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

Changes screenshot size to thumb

This page describes the initial setup procedure of phTagr to initialize and configure phTagr. It assumes that you successfully installed all the required software (see HowToInstall or HowToInstallInUserDir).

You init phTagr either through the system wide environment http://localhost/phtagr/setup or through your home directory http://YOUR_SERVER_URL/~YOUR_NAME/phtagr/setup.

All modifications assumes that you are in the directory of phtagr (e.g. /var/www/phtagr or ~/public_html/phtagr).

Watch the setup procedure at youtube


If you receive only warning text with something like Warning: _cake_core_ cache was unable to write 'cake_dev_en-us' to File cache in /mnt/raid/var/www/tests/phtagr/cakephp/lib/Cake/Cache/Cache.php on line 306 (See screenshot you need to set the file permission of your ./tmp directory properly.

Security Salt

phTagr has a security salt which is used for password and session encryption. Therefore this must be changed first (otherwise the setup session would not working properly). If the file ./Config/core.php is writeable phTagr changes the security salt by its own. Otherwise you get an hint to change it manually


If your web server, cake and phTagr are working properly (and the security salt is changed), you get an welcome screen

Continue on clicking on Start installation.


phTagr checks if the required paths are writeable. Usually it should be already done in the install procedure but maybe something went wrong. So you get following screen to change the paths

Information: The user path is uses to store all uploaded data and preview cache files of the users. The tmp directory is used for system cache files and for debug and log files.

Database Connection

Now phTagr request the correct database connection. If phTagr can write into the path ./Config you will get following screen to complete all the settings for you database connection

If the directory ./Config is not writable you get an sample file for the database which should be writen to ./Config/database.php. Please edit the page by your own.

An example configuration ./Config/database.php file looks like:



   * Default database connection configuration
  var $default = array(
                  'datasource' => 'Database/Mysql',
                  'persistent' => true,
                  'host' => 'localhost',
                  'database' => 'phtagr',
                  'login' => 'phtagr',
                  'password' => 'phtagr',
                  'prefix' => 'pt_',
                  'encoding' => 'utf8'

   * Database connection configuration for test environment
  var $test = array(
                  'datasource' => 'Database/Mysql',
                  'persistent' => true,
                  'host' =>; 'localhost',
                  'database' => 'phtagr',
                  'login' => 'phtagr',
                  'password' => 'phtagr',
                  'prefix' => 'pt_test_',
                  'encoding' =>'utf8'

After successful database connection phTagr initializes now all the required tables.

Admin User

phTagr requests now some data for the admin account.

Please fill out the form with our prefered name, password and email. This email will be used for password recovery or comment notification.

Note: The admin account gets an initial upload quota of 100 MB. This could be changed later in the system preferences.

External Programs

phTagr could use some external programs for some advanced features (e.g. create video thumnails, flash videos, or writing meta data back to the photos). These external helper programs are optional and could be set here. phTagr searches in /usr/bin, and /usr/local/bin for these files. You have to enter it manually if phTagr could not find it - or you can set them later in the system preferences.

Note: To create proper flash videos ffmpeg should be built with mp3 support! See CreateFlashVideo


phTagr is now completely installed and ready to rock! Congratulations! Now continue with the FirstSteps...