Quick BB
PHP 8.2+ & MySQL Buy license · $79.95
Getting started

How to Install Forum Software on Shared Hosting

Install a PHP forum on ordinary shared hosting: check your plan, upload files, create a database, run the installer and fix common errors.

Updated 5 minute read The Quick BB team

You do not need a dedicated server or command-line skills to run a forum. Most PHP and MySQL forum software installs on ordinary shared hosting with nothing more than a file manager and a web browser. This guide covers the whole process, from checking your plan to locking down the installer when you are done.

Before you start: check your hosting plan

Shared hosting plans vary a lot, so confirm a few things before you upload anything:

  • PHP version. Use a version that still receives security fixes. Quick BB requires PHP 8.2 or newer and is built for 8.2, 8.3, 8.4 and 8.5.
  • Database. MySQL 8.0 or newer, or a compatible MariaDB, with the PDO MySQL extension enabled and utf8mb4 support.
  • Web server. Apache and LiteSpeed are the most common on shared hosting. If your host uses Nginx, you will need the Nginx instructions supplied with the software.
  • Database access. You must be able to create a database and a database user from your control panel.
  • HTTPS. Install an SSL certificate for your domain before you install the forum, so the forum URL starts with https:// from day one.

Most hosts let you pick the PHP version per domain in the control panel. If you are not sure what you have, see our forum software requirements guide.

Step 1: Decide where the forum will live

Choose the address before you upload, because changing it later means updating links, redirects and settings. Common choices are:

AddressUpload toWhen to use it
example.comThe domain's web root (often public_html)The forum is the whole site
example.com/forum/A forum folder inside the web rootYou already have a main website
forum.example.comThe folder your host creates for the subdomainYou want the forum kept separate from the main site

All three work. A subfolder keeps everything under one domain, which is simple to manage. A subdomain is useful if your main site runs different software.

Step 2: Upload the files

Download the forum software ZIP and extract it on your computer first, so you can see the folder structure. Then upload the files using one of these methods:

  • File manager. In your hosting control panel (often cPanel), open the file manager, go to the target folder, upload the ZIP and use the Extract option. This is usually the fastest method because the server unpacks everything in seconds.
  • FTP or SFTP. Connect with an FTP program using the details from your host and upload the extracted files. Use SFTP or FTPS if your host offers it, so your password is not sent in plain text.

Make sure the files end up directly in the folder you chose, not in an extra subfolder. For example, if you wanted the forum at example.com/forum/, then install.php should be at public_html/forum/install.php, not public_html/forum/quickbb/install.php.

If you upload by FTP, check that the transfer finished without errors. A partly uploaded file is one of the most common causes of a blank page during installation.

Step 3: Create an empty database

The installer creates the tables, but it needs an empty database to put them in. In your control panel:

  1. Create a new MySQL database.
  2. Create a database user with a strong, unique password.
  3. Add the user to the database and grant it all privileges on that database.
  4. Write down the database name, username, password and host.

On most shared hosts the database name and username get an account prefix added automatically, so copy the full names exactly as the panel shows them. For a screen-by-screen explanation, read how to create a MySQL database for a forum.

Step 4: Run the installer

Open the installer in your browser, for example https://example.com/forum/install.php. Quick BB's installer has 8 steps:

  1. Requirements check. Confirms your PHP version, PDO MySQL and other needs. Fix anything marked as missing before you continue.
  2. Database details. Enter the database name, user and password. The host defaults to localhost and the table prefix defaults to forum_. Use the test button to confirm the connection works.
  3. Tables. The tables are created automatically.
  4. Forum details. Your forum name and basic information.
  5. Admin account. Choose an admin username that is not "admin", and a long, unique password.
  6. Default skin. Pick one of the 11 bundled skins. Classic Blue is the default and you can change it later. See the skins list.
  7. Features. Choose which features to turn on.
  8. Done. The installer locks itself so it cannot be run again.

Nothing in this process needs SSH, Composer, Node, Docker or Redis. If your host offers cron jobs, the software will use them, but cron is not required.

Step 5: Secure and test the new forum

Once the installer finishes, take a few minutes to check everything works:

  • Log in to the Admin CP with your new account and set up two-factor authentication. Quick BB requires it for admins by default, using any TOTP authenticator app.
  • Configure SMTP and send a test email, so registration and password reset emails arrive. See set up forum email with SMTP.
  • Register a test member in a private browser window to check the CAPTCHA, verification email and first post all work.
  • Visit a few forum and thread pages to confirm friendly URLs load correctly.
  • Run your first backup from the admin area, so you have a clean starting point.

Troubleshooting common install problems

The installer shows a blank page or an error 500

This usually means a file did not upload completely, or the domain is running an older PHP version. Re-upload the files and check the PHP version selected for that domain or folder in your control panel.

The database test fails

Double-check the full database name and username, including any account prefix. Confirm the user was actually added to the database with privileges. If localhost does not work, your host's help pages will list the correct database host name.

Friendly URLs return "not found"

On Apache and LiteSpeed this is usually a missing or ignored rewrite file. Make sure hidden files were uploaded, since some FTP programs skip files that start with a dot. On Nginx, follow the supplied Nginx instructions, because Nginx does not read those files.

Keeping the forum up to date

When an update comes out, upload the new files and open upgrade.php. It asks you to log in as an admin, warns you to back up first, runs the database migrations and keeps a log. Always take a backup before upgrading. Our guide to upgrading forum software safely covers the full routine.

If you have not picked your software yet, the Quick BB quick start shows the install from download to first post.

Frequently asked questions

Can I install forum software without SSH?

Yes. Quick BB installs with FTP or your host's file manager and a web browser. No SSH, Composer, Node, Docker or Redis is needed.

Should my forum go in a subfolder or a subdomain?

Both work. A subfolder such as example.com/forum/ keeps everything under one address, while a subdomain such as forum.example.com keeps the forum separate from your main site.

Why does the installer show a blank page?

Usually a file did not upload completely or the domain is using an old PHP version. Re-upload the files and check the PHP version selected in your control panel.

Get three guides like this every month, plus software update notices.Subscribe →