MyBB Documentation

Installer

The 1.6 Documentation is no longer maintained and some information may be outdated.

The MyBB 1.6 series reached end of life on October 1, 2015.

This means there will be no more security or maintenance releases for these series and forums running these versions of MyBB may be at risk of unfixed security issues. All administrators are strongly encouraged to upgrade their forums to the latest release of MyBB as soon as possible.

Installation Guide
Preparation
  1. Uploading Files
  2. CHMOD Files
Installer
  1. Welcome
  2. License Agreement
  3. Requirements Check
  4. Database Configuration
  5. Table Creation
  6. Data Insertion
  7. Theme Installation
  8. Board Configuration
  9. Administrator User
  10. Finish Setup

This page outlines the pages of the MyBB installer. The pages that require user input are on separate pages with more details.

The installer is found in the "install" directory within the MyBB folder. For example, if your forum is located at: http://www.example.com/forum/ , you will find your installer at http://www.example.com/forum/install/. If you are unable to find the installer, please recheck that you have uploaded your files in the correct location (consult your web host to check).






Installer: Welcome

Welcome

This page welcomes you to the installer. All you need to do on this page is click the "Next" button.

« CHMOD Files License Agreement »


Installer: License Agreement

License Agreement

You must read and agree to the license agreement before you can install MyBB. You must adhere to the license agreement at all times while the board is installed. After reading the agreement, click the "Next" button on this page.

« Welcome Requirements Check »


Installer: Requirements Check

Requirements Check

This page checks that your server meets the requirements for running MyBB. If it does not, you will be notified on this page. If everything is working correctly, all you need to do is click on the "Next" button on this page.

« License Agreement Database Configuration »


Installer: Database Configuration

Database Configuration

This page is for the configuration of your database. If you have javascript enabled, only fields relevant to your selected engine will be displayed. Below is an explanation of each field:

Database Engine
This is the engine that you wish to use. At most, the options available will be MySQL, MySQL Improved, SQLite 3, or PgSQL. Most likely, there is only MySQL or something similar, so this should be the right choice for you. If you have the option between MySQL and MySQL Improved, usually the Improved is the better choice.
Database Host
This is the server where the database is. Unless told otherwise by your host, this should be localhost. This option is not necessary for SQLite installations.
Database Username
This is the username you created or you use to access your database for MyBB. This option is not necessary for SQLite installations.
Database Password
This is the password for the database username that you entered. This option is not necessary for SQLite installations.
Database Name
This is the name of the database that you would like MyBB to install to. This option is not necessary for SQLite installations.
Database Path 
This is the path where you want to save the SQLite file. This option is only necessary if you have selected 'SQLite 3
Table Prefix
This is the prefix for the tables in the database. Unless you already have a MyBB installation in the database you entered with the prefix mybb_, you should leave this how it is. If you do already have a MyBB installation in the database, you should change it to something else.

Once you have entered the details correctly, you should click on the "Next" button on the page. If the installer cannot access the database, you will be told so, meaning you did not enter one (or more) of the details correctly.

If you are having trouble with this step, contact your webhost to see what is the correct host/username/password to use. This usually can be found in your host's control panel (eg. cPanel, Ensim, DirectAdmin, Plesk) or by contacting your web host's support.

« Requirements Check Table Creation »


Installer: Table Creation

Table Creation

In this step, the database tables are inserted. No user input is needed on this page, so click the "Next" button when it appears. This page may take several moments to load, so please be patient while it does and inserts the database tables.

« Database Configuration Data Insertion »


Installer: Data Insertion

Data Insertion

In this step, the default data is inserted into the database tables created above. No user input is needed on this page, so click the "Next" button when it appears.

« Table Creation Theme Installation »


Installer: Theme Installation

Theme Installation

The theme data is loaded into the forum at this point. No user input is needed on this page, so click the "Next" button when it appears.

« Data Insertion Board Configuration »


Installer: Board Configuration

Board Configuration

These are settings that are critical to running your board. MyBB tries to fill these settings with the correct value; however, you should double check to make sure these settings are set properly.

Forum Name
This is the name of the forums that you are installing. By default, it is "Forums"
Forum URL
This is the URL to your forums. This should be filled in automatically, but it is always good to make sure that the URL is correct. Remember that there should not be a trailing slash
Website Name
This is the name of your website (if you have one). This setting is for the "Your Website" link at the bottom of the forums. The name is simply the text that you wish to use for the your website link.
Website URL
This is the URL to your website (if you have one). If you do not have a website, you can either leave it blank or enter your forums URL.
Cookie Domain
This is the domain for the cookie to be set to. In versions 1.4 and later, this field is pre-filled with the appropriate data. (See Cookies)
Cookie Path
This is the path for the cookie to be set to. If you have more than one MyBB installation on the domain, it is recommended that you change this to the path to your forum (for instance, /forums/). In versions 1.4 and later, this field is pre-filled with the appropriate data. (See Cookies)
Contact Email
This is your email address that your members can contact you by via the "Contact Us" link at the bottom of your forum. This is also the forum webmaster's email that will be used when the forum sends emails.


« Installation Guide Administrator User »


Installer: Administrator User

Administrator User

The administrator account is the first account on your forum (identified by the user ID #1). This account has permissions to all sections in the Admin Control Panel.

Username
This is the username of the administrator account that you are creating.
Password and Retype Password
This is the password for the administrator account. Be sure to type it in correctly in both fields.
Email Address
This is the email address that the administrator account will be created with.


« Board Configuration Finish Setup »


Installer: Finish Setup

Finishing Setup

Congratulations! If you have reached this page, then you have successfully installed your MyBB. You should remove the /install/ directory from your server now, to prevent anyone else from running the installation again. MyBB will not run unless the installer is locked, or removed.

If you simply wish to lock your MyBB install directory, simply create a new file in the install directory called lock, which will disallow access to the installer/upgrader while it exists.

« Administrator User Installation Guide Start »


Edit this page on GitHub