PhpBB2

From A2Wiki

Non-Fantastico Install of phpBB2

1. Create your database. Log in to cPanel and go to 'MySQL Databases'. Create a new database called 'phpbb' (this can be called whatever you want, but we'll assume 'phpbb' here). cPanel will automatically rename the database once you've created it, prefixing the name you entered with your user name, so your database will actually be called

   username_phpbb

   Where 'username' is your main cPanel username.
   
   
2. Create a user for the database. In cPanel->'MySQL Databases', create a new user called 'phpbbuser' (again, the user can be named whatever you want, but we'll assume 'phpbbuser'. cPanel will rename this user automatically the same way it renamed the the database:

   username_phpbbuser

   Set the password to whatever you'd like.
   
   
3. Add the user you've created to the database you've created. In cPanel->'MySQL Databases', go to 'Add Users to Your Databases'. In the 'User' field, select 'username_phpbbuser' and in the 'Database' field, select 'username_phpbb'. Check 'ALL' for 'Privileges'. Click 'Add User to Database'.
   
   
4. Download the latest version of phpBB from http://www.phpbb.com/downloads.php (download the .tar.gz version)
   
   
5. Transfer the file to your ~/public_html directory via FTP/SFTP
   
   
6. Log in to your account via SSH and type
   
   cd ~/public_html
tar xzf phpBB-x_version_x.tar.gz
   
   Where 'x_version_x' is the version-specific part of the file name.
   
   Keep your SSH shell connection open because you'll need it for some of the next steps.
   
   
7. You'll need to change permissions for the config.php file so that it is writeable by the installer. In the shell, run the following commands:
   
   cd ~/public_html/phpBB2
chmod 777 config.php
   
   
8. Open your web browser and go to
   
   http://yourdomain.tld/phpBB2
   
   
9. Settings
   
   Database Type: 'MySQL 4.x/5.x'
   Choose your installation method: 'Install'
   Database
   Server Hostname / DSN: 'localhost'
   Your Database Name: 'username_phpbb' (as specified in step 1)
   Database Username: 'username_phpbbuser' (as specified in step 2)
   Database Password: 'your_password_here' (the password you set in step 2)
   Prefix for tables in database: Use the default 'phpbb_'
   Admin Email Address: 'your_email@yourdomain.tld'
   Domain Name: 'yourdomain.tld'
   Server Port: '80'
   Script path: '/phpBB2/'
   Administrator Username: Set this to the username you'd like to user for phpBB
   Administrator Password: Set this to whatever you'd like
   Administrator Password [Confirm]: Enter your password again
   
   
10. You should now see a page with the following:
    
    "Your admin username has been created. At this point your basic installation is complete. You will now be taken to a screen which will allow you to administer your new installation. Please be sure to check the General Configuration details and make any required changes. Thank you for choosing phpBB 2."
    
    Click 'Finish Installation'. This will take you to the Admin page.
    
    
11. In the shell, run the following commands to delete the '/install' and '/contrib' directories as instructed.
    
    cd ~/public_html/phpBB2
rm -rf install
rm -rf contrib

    
    
12. You can login to administrate phpBB at
    
    http://yourdomain.tld/phpBB2/login.php
    
    and then click 'Go to Administration Panel' at the bottom of the screen.
13. OPTIONAL:
    
    If you'd like to set up your phpBB installation to be accessible using an alternate diretory name, you'll need to create a symlink to the phpBB installation directory. Log in to the shell via SSH and enter the following commands:
    
    cd ~/public_html
ln -s /full/path/to/phpBB link_name
    
    Where '/full/path/to/phpBB' is the path to phpBB2 ('~/public_html/phpBB2' if set up as instructed here) and 'link_name' is the alternate name. For example,
    
    cd ~/public_html
ln -s phpBB2 bb
    
    Would make phpBB accessible at
    
    http://mysite.com/bb