PunBB 1.0 Installation

NOTE: If you are upgrading from 1.0 RC 2, skip to section 3.

1. Requirements

MySQL: Version 3.23 or later is recommended. PunBB will probably work with older versions though.

PostgreSQL: PunBB 1.0 has only been tested on version 7.3.3 of PostgreSQL. It should work fine with any version greater than 7.0 though. If the installer complains about not being able to create an index, open up install.php and search for "PostgreSQL <7.3 note".

2. Installation

Copy/upload all files and directories and run install.php from the forum root directory. Follow the instructions. If you get an error when trying to upload avatar images, make sure that PHP has write access to the directory where you store avatars (default is img/avatars). Please report any problems you might encounter during installation in the forums at http://forums.punbb.org/.

3. Upgrading from 1.0 RC 2

Follow these instructions to update your current 1.0 RC 2 installation to 1.0 final. It is recommended that the forum be put into maintenance mode (Admin/Options) during the update procedure.

NOTE: Make a backup before proceeding! Use the tool mysqldump for MySQL and pg_dump for PostgreSQL. Also backup any CSS and template files that you have made changes to.

  1. Update all scripts and files to 1.0. This is easily done by extracting the 1.0 archive into the same directory as your old installation (overwriting any existing files).
  2. Copy the script 10_rc2_to_10_update.php from the directory "extra" to the forum root directory and run it once. A message will appear when the update process has completed. Once the update script has finished you should remove the script from the forum root directory.
  3. Update any custom made css files so that the identifier names no longer contain the character underscore. I.e. make "pun_head" into "punhead".

You should now be running PunBB 1.0.

3. Maximizing performance

Here are some recommendations for maximizing the performance of PunBB. The recommendations are not directly related to PunBB performance. They are very general and results may vary.

Thank you for using PunBB.

Rickard Andersson
punbb@telia.com
http://www.punbb.org/