Switch to English Guide
YaBB Quick Start Guide

Upgrading from YaBB 2.x

For detailed instructions, please view YaBB Codex Installation Guide.

The Setup ScreenIf you are trying to upgrade your existing YaBB 2 installation, there are a few simple steps that need to be taken in order to correctly complete the process. Before you begin, however, please make sure you have a full backup of your working YaBB. It is also advised that you inform your users you will be upgrading before you begin.

As soon as you're ready, place your forum into Maintenance Mode by going into your Admin Center and under the section titled "Forum Configuration", click ther link "Forum Settings". There you will see a checkbox with the label "Maintenance Mode". Check this box and save the changes.


  1. If you are upgrading from a beta version of YaBB 2, open Settings.pl from your website and add $cookiesession_name = "Y2Sess-55694"; into the file if it does not already exist. This will set the session cookie name for your upgrade and will prevent any problems when you're finished.
  2. If you are upgrading from a YaBB 2 beta earlier than YaBB 2.0 Pre-Release, open FixFile.pl inside a text editor and change the path to Perl to match your server's requirement.
  3. From the new YaBB 2 package, upload the following files, overwriting existing/old versions:
    • cgi-bin/yabb2/AdminIndex.pl
    • cgi-bin/yabb2/FixFile.pl (chmod 755)
    • cgi-bin/yabb2/YaBB.pl
    • cgi-bin/yabb2/Admin/*
    • cgi-bin/yabb2/Help/*
    • cgi-bin/yabb2/Languages/*
    • cgi-bin/yabb2/Sources/*
    • cgi-bin/yabb2/Variables/Menu0.def
    • cgi-bin/yabb2/Variables/Menu1.def
    • cgi-bin/yabb2/Variables/Menu2.def
    • public_html/yabbfiles/* (Except for /Attachments/ and /Smilies/)
  4. In your /Variables data folder, *delete* the following files so YaBB can regenerate them:
    • cgi-bin/yabb2/Variables/Admin.helporder
    • cgi-bin/yabb2/Variables/Gmod.helporder
    • cgi-bin/yabb2/Variables/Moderator.helporder
    • cgi-bin/yabb2/Variables/User.helporder
  5. Once the uploading and deleting is complete, DO NOT visit your board just yet. If you are upgrading from anything earlier than YaBB 2.0 Pre-Release, point your browser to FixFile.pl and run this utility. This will update the file structure for your YaBB 2 data.
  6. As soon as FixFile.pl has finished, delete that file so it cannot be run again! You may then visit your forum again.