Switch to English Guide
YaBB Quick Start Guide

Step 2 - Uploading YaBB



  1. Your host should specify what folder(s) you may run Perl/cgi scripts in. Some may allow them only in the cgi-bin directory, On some web hosts, it is not required that Perl scripts reside in this cgi-bin folder. Verify this before proceeding. Others may allow anywhere in or below the public_html folder, this is totally up your host, and they can advise you if you are not sure. Use these examples as a guide. In your 'cgi-bin', create a directory called "yabb2" (or whatever name you wish to use in your forum's URL). See the example file structure provided below.
    Note: if you are upgrading from a previous version of YaBB, please check Converting prior to installing your new YaBB 2.5.2 forum. Also, note that Windows servers, unlike *nix servers, are case-insensitive. In this case 'avatars', 'Avatars', and 'AvAtars' refer to the same Windows folder or file - on *nix these are all different folder/file names. This can cause issues if you are moving a forum from a *nix server to a Windows one and files have similar case-sensitive names.
  2. Upload all of the files in ASCII mode from the 'cgi-bin/yabb2' folder into your new folder. You can select all of the folders and files at once to upload them in one step if you desire. Do not rename any of these folders for now, or the automatic path detection will not work when you run the setup script. You should have a folder structure similar to the following when this is complete:
    • cgi-bin/yabb2
    • cgi-bin/yabb2/Admin
    • cgi-bin/yabb2/Backups
    • cgi-bin/yabb2/Boards
    • cgi-bin/yabb2/Help/English/Admin
    • cgi-bin/yabb2/Help/English/Gmod
    • cgi-bin/yabb2/Help/English/Moderator
    • cgi-bin/yabb2/Help/English/User
    • cgi-bin/yabb2/Languages/English
    • cgi-bin/yabb2/Members
    • cgi-bin/yabb2/Messages
    • cgi-bin/yabb2/Modules/Archive/Tar
    • cgi-bin/yabb2/Modules/Archive/Zip
    • cgi-bin/yabb2/Modules/Digest
    • cgi-bin/yabb2/Modules/Email/Date
    • cgi-bin/yabb2/Modules/MIME
    • cgi-bin/yabb2/Sources
    • cgi-bin/yabb2/Templates/default
    • cgi-bin/yabb2/Templates/yabb21
    • cgi-bin/yabb2/Variables
  3. Then, in a section of your webspace (outside the cgi-bin, generally in a 'public_html' or 'htdocs' folder, as suggested in the package's folders), create another directory called 'yabbfiles.'
  4. Upload all of the files from the 'public_html/yabbfiles' folder (DO NOT Use the AUTO Transfer mode!) into your new folder. All files should be uploaded using ASCII except for these file types: .gif, .jpg, .png, and .swf, which must be transferred using Binary mode. Do not rename any of these folders for now, or the automatic path detection will not work when you run the setup script. Note: Three of the folder names do not begin with capital letters. You should have a folder structure similar to the following when this is complete:
    • yabbfiles/
    • yabbfiles/Attachments
    • yabbfiles/avatars/UserAvatars
    • yabbfiles/Buttons/English
    • yabbfiles/googiespell
    • yabbfiles/greybox
    • yabbfiles/ModImages
    • yabbfiles/Smilies
    • yabbfiles/Templates/Admin/default
    • yabbfiles/Templates/Forum/default
    • yabbfiles/Templates/Forum/yabb21