BrewBlogger 2.1.0.1 Installation Instructions

Step 1: Configure the Database Connection

  1. Extract the zip file to a location on your local computer.
  2. Find the location where you unzipped 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.1.0.1_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 Your Preferences

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

Help

  1. Access BrewBlogger Help if you are stuck.