Bloo Installation Instructions

Note: These instructions are for new installations of Bloo. If you are wanting to upgrade an existing version of Bloo, please read the Bloo Upgrade Instructions


To install and run Bloo, you need space on a webhost that you can upload files to, and the webhost needs to be configured to run PHP and MySql.

Install steps

  1. Create an empty mysql database on your webhost and a userid on that database that has the rights to create and alter tables.
  2. Download the latest release of Bloo and unzip or decompress the release package to a local directory of your choosing. Note: The tarball (tgz) file can be decompressed by using this command: tar xvzf bloo.v.1.35.tgz
  3. Copy or rename the bloo.config_template.php file to bloo.config.php. Edit the bloo.config.php, setting the first four parameters (database configuration). The server is almost always going to be "localhost". The userid, password, and database should match what was created in step 1. Note: The fifth parameter is the name of the lists table, where settings will be stored. You can, in general, leave this setting alone, but if you plan on using a prefix on your tables other than "bloo_", you should change the prefix to the lists table also.
  4. Upload all the files and directories to an appropriate place on your webhost. Examples might be the /www directory, the /www/blog directory, etc.
  5. Run the bloo.install.php program, which is in the root of the upload location.
  6. Fill out the information requested. This info (name of blog, tagline, admin userid information, time zone information, password choice, etc) is needed for blog creation. Please take note of/remember your password.
  7. Press the Submit button. If all goes well, your blog will be created and ready for posting within a few seconds. If you get error messages, most likely the problem has to do with the database configuration setup in step 3.

A note on the install "ping": the last step of the install program is to send a "ping" to All this does is let the main Bloo website know that an install of Bloo has occurred. This is strictly so that we can know who's using Bloo, and only to satisfy our curiosity and to see how the community of Bloo bloggers is growing. No private information is sent in the ping (what's sent is your blog name and url). If, however, you'd prefer that the notification of your install not be "pinged" to, please edit the bloo.install.php program (prior to the install, of course) and make the following change:

CHANGE "define( "SEND_PING", true );" TO define( "SEND_PING", false );

This will prevent the ping from being sent. But it would be really cool of you to leave the SEND_PING option to true, because we'd like to know that you installed Bloo.

If you have problems, please note the reported error messages and leave a message on the Bloo Feedback Page.

You also might find it helpful to visit the Bloo Development Blog.