phpCollab - project managment collaboration

phpCollab Installation Guide

This page covers first-time installation; for upgrading an existing PhPCollab implementation, see the "Upgrading PhpCollab."

  1. Extract files from zip into one folder (ie - "phpcollab")
  2. Unix/Linux: Rename the file "settings_blank.php" (includes/settings.php) to "settings.php"
  3. Unix/Linux: change permissions (chmod) to 777 on the following files/folders (you may also have to perform a "chown apache"):
    • "includes/settings.php" file
    • "files" folder
    • "logos_clients" folder
  4. Create a new MySql, PostgreSQL or Sql Server database to house the PhPCollab data (the install utility will create all the tables so long as the database exists)
  5. Open a window in either Internet Explorer or Netscape Navigator and enter the URL of the setup.php file in your installation of phpcollab (ie -
  6. Read the GNU License Agreement, scroll to the bottom of the page and click the "Step 2" link (Note: if you are creating this inside a firewall, ie for intranet only use, click the checkbox next to "Offline installation..." at the bottom of the page)
  7. The "Settings" Page will appear, as below:

    Installation Settings  Screen

    - Installation Type - defaults to "Online"
    - Database Type - defaults to "MySQL"
    - Database Server - the name of your server (for instance "localhost"); check with your web server administrator if you are unsure of the name of the database server
    - Database Login - create a new user to access this particular database (in some cases, you will need to append your host server login to the database username, ie - "yourdom_username")
    - Database Password - create a password for the database user login (not for the admin in the phpcollab interface, which is the last field, "Admin password")
    - Database Name - the name of the database you created in Step 4 of this Installation Guide (in some cases you will need to append your host login to the database name, ie - "yourdom_phpcollab")
    - Table prefix - you would only need to set this property if you had multiple installations of phpcollab running in the same database
    - Create Folder Method - (defaults to "PHP") for safe-mode, use FTP; if safe-mode is off, use PHP
    - Notifications - (defaults to "True") if set to "True," the system will allow users to receive automatic updates when certain project changes/updates occur; valid sendmail class must be installed on the server
    - Forced Login - (defaults to "False") if false, you will not be able to setup an external login page
    - Default Language - (defaults to "Blank") if left blank, the PhPCollab will choose the language based on the browser's default language settings; there are 29 languages from which to choose if you would prefer to set to a single language
    - Root - automatically populates with the location of the original installation from step 1; do not change unless you have changed the location of the phpcollab files since starting the installation wizard
    - Login Method - (defaults to "Crypt") referes to method for securing the storage of passwords in the database: "Crypt" uses the htaccess file and cvs authentication, which must be enabled; "Md5" is a one-way hashing algorithm that is highly secure; and "Plain" is normal password encryption
    - Admin Password - set the password that the PhPCollab administrator will use to log into the user interface (different from the database password)

  8. Click on the "Please log in" link on the "Control" Page that appears after you have successfully installed the systems and set its properties properly
  9. When the login page appears, type "Admin" for username and the password you set in the last item of step 7 (after you log in you will be able to create the other system users)
  10. After successfully logging in, delete the "setup.php" file, which is located in the"installation" folder
  11. Edit settings by clicking on the "Edit Settings" link on the "Administration" Page or if you are an advanced user, manually edit the "settings.php" file located in the "includes" folder
Copyright (c) 2003 Michelle L. Feldman ( Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License."
powered by phpCollab Rate PhpCollab | Site Map | Privacy Policy | Contact Us | ©2003 phpCollab team | back to top