Installation Instructions

Print This Page

Step 1: Configure the Database Connection

  1. Extract the archive file to a location on your local computer.
  2. Find the location where you extracted the file and open the folder.
  3. From there, open the folder named brewBlogger.
  4. Then, open the folder named Connections.
  5. Locate the file named config.php.
  6. Using your favorite text editor or WYSIWYG program, open config.php.
  7. Insert the username and password provided by your web hosting company — be sure to read the help text above each line.
  8. If you plan on utilizing the Bottle Label upload function, designate the path of the label_images folder.

Step 2: Upload

  1. Using your favorite FTP program, upload the entire contents of the BrewBlogger folder (but not the folder itself) to your web server's root directory.
  2. If you plan on utilizing the Bottle Label upload function, you will need to change the permissions (CHMOD) of the label_images folder to 777 (read-write). Your FTP program should be able to do this.

Step 3: Open phpMyAdmin

  1. Your web hosting company most likely has phpMyAdmin available to its users. If not, you can download the software by going to the phpMyAdmin website. It's free and easy to install.
  2. Using your browser, go to your hosting account's phpMyAdmin site. You may have to browse to your account's control panel to access phpMyAdmin.

Step 4: Create the Database**

  1. Type brewlog in the field under the heading Create new database.
  2. Click Create.
** Note: some hosting companies limit the number of database installs. This method of creating a database may not be possible. If not, consult your hosting company's documentation.

Step 5: Dump the Tables and Data

  1. On the next page that appears, click the SQL link.
  2. From there, click Browse to find a location of a text file.
  3. Find the location where you unzipped the folder and open it.
  4. Open the sql folder.
  5. Select the file called 2.3.2_new_install.sql and click Open.
  6. Click Go.
  7. The database tables and default data will be installed.
  8. Browse to your installation's URL — you are now ready to use BrewBlogger!

Step 6: Initial Use

  1. Launch your browser and access your BrewBlogger installation.
  2. Click "Login" on the main navigation bar.
  3. To log in as an admin/privledged user:
    1. In the username field, enter admin.
    2. For the password field, enter user.
  4. To log in as an non-privledged user (non-privledged users for use with the Club Edition - see Step 7 below):
    1. In the username field, enter nonpriv.
    2. For the password field, enter user.
  5. This will take you to BrewBlogger's administration section.
  6. Once you've accessed the admin section, for security reasons, you should change or delete BOTH of the default username/password combinations.

Step 7: Set Site Preferences

  1. In the administration section, roll over General in the navigation bar.
  2. Choose Edit Preferences from the list.
  3. From there, you can choose your theme, the edition (Single- or Club/Multi-user), printing permissions, and display parameters.

Step 8: Set Your Personal Preferences

New in BrewBlogger 2.3 is the ability for every user to set up their own personalized preferences for a number of items. To do this:

  1. Access the administration section.
  2. From the main list, under the General heading, click Edit Personal Defaults and Info.
  3. From there, you and each one of your members (if using the Club option), can designate a default:
    1. Brewing method
    2. Batch size
    3. Bitterness formula
    4. Equipment profile
    5. Mash profile
    6. Water profile
    7. Boil size