Nothing in the guide matches that search. Try a different word, or contact support.
Overview
Quick BB is self-hosted discussion forum software for PHP and MySQL. It recreates the classic message-board layout - category tables, compact thread lists, breadcrumbs, numbered pages and two-column posts - and adds the tools a modern forum needs: spam protection, private messages, moderation, built-in advertising and search engine optimization.
Your forum runs on your own web hosting and your data stays in your own database. The forum only contacts the license server when you enter your key or click Check License Status - never automatically.
The forum has three areas: the forum your members use, the Moderator CP for your moderators, and the Admin CP, where every setting lives.
Requirements
| Item | Requirement |
|---|---|
| PHP | 8.2 or newer (Quick BB targets PHP 8.2, 8.3, 8.4 and 8.5). Choose a version that still receives security updates. |
| Database | MySQL 8.0 or newer, or a compatible MariaDB version, using utf8mb4 |
| PHP extensions | PDO with the MySQL driver, plus the common extensions install.php checks for |
| Web server | Apache or LiteSpeed (ordinary shared hosting is fine). Nginx works with the supplied configuration instructions. |
| Not needed | SSH, command-line tools, Composer, Node.js, Docker, Redis, Elasticsearch or root access |
The installer checks all of this for you on its first screen and explains anything that is missing.
Installing with install.php
Before you start
- Unzip the Quick BB download on your computer.
- Upload the files to your website with FTP or your hosting file manager - to the web root for
example.com, or a folder such as/forum/forexample.com/forum/. - In your hosting control panel, create an empty MySQL database and a database user, and give the user all privileges on that database. Write down the database name, user name and password.
- Open
install.phpin your browser, for examplehttps://example.com/forum/install.php.
The eight steps
| Step | What happens |
|---|---|
| 1. Welcome | Checks your PHP version, extensions, database support and folder permissions, with a clear pass or fail for each. |
| 2. Database | Enter the host (usually localhost), database name, user, password and table prefix (default forum_). Use Test Database Connection before you continue. |
| 3. Database installation | Creates every table and the initial settings. It is safe to retry, and it will never overwrite an existing installation. |
| 4. Forum details | Forum name, description, address (URL), administrator email and time zone. |
| 5. Administrator | Your admin username, email and password. |
| 6. Theme | All 11 skins are installed. Classic Blue is the default; pick another if you prefer. |
| 7. Features | CAPTCHA, rate limits, flood control, private messages, ignore lists, tags, SEO, sitemaps and the ad zones start switched on (the two ad sidebars start off). You can add sample forum content. |
| 8. Complete | Links to your forum and the Admin CP. The installer locks itself and creates your site's security secrets. |
First steps after installing
- Create your categories and forums in Forum Management. Start with a few broad forums - you can add subforums later.
- Check usergroups and permissions so guests, new members, established members and moderators can see and do the right things.
- Set up email (SMTP) and send a test email, so verification and password emails arrive.
- Write your forum rules and terms, and link your privacy policy. Members can be asked to accept them when they register.
- Review spam settings - the defaults are a sensible start.
- Upload ads if you plan to show them. Empty ad zones show nothing.
- Make your first backup.
The Admin CP
Every setting is in the Admin CP, so you never need to edit PHP files. It is organized into these areas:
| Area | What it covers |
|---|---|
| Forum Management | Categories, forums, subforums, descriptions, display order, permissions and forum-specific skins |
| Member Management | Search and edit members, usergroups, ranks, bans, suspensions, registration approval and profile fields |
| Security | CAPTCHA, flood control, registration limits, word filters, banned IPs and email domains, security logs |
| Advertising | Banner uploads, zones, scheduling, rotation and statistics |
| SEO | Friendly URLs, titles, meta descriptions, canonicals, tags, hashtags, sitemaps and structured data |
| Theme Management | Installed skins, default skin, custom skin creator, colors, logos, import and export |
| Community Settings | Private messages, ignore lists, reputation, ranks, subscriptions, notifications and forum rules |
| Maintenance | Backups, restores, upgrades, importers, cache clearing, recounts, search and sitemap rebuilding, logs and diagnostics |
Skins and the Style Manager
Quick BB includes 11 skins that share the same layout: Classic Blue (default), Classic Amber, Classic Red, Golden Yellow, Forest Green, Vintage Brown, Midnight Black (a complete dark skin), Classic White, Royal Purple, Slate Grey and Ocean Teal.
For members
Members change skin from the style chooser at the bottom of every page. Registered members' choice is saved to their account, guests' choice in a cookie, and Reset to Forum Default goes back to your default.
For administrators
- Set the default skin, and enable or disable skins.
- Duplicate a skin, rename it, change its colors with color pickers or edit its CSS variables, and upload a skin-specific logo. Preview before saving.
- Give individual forums their own skin, and choose whether that overrides members' own choice.
- Import and export skins. Imported skins can never run PHP or JavaScript. Restore a bundled skin at any time.
Forums, threads and posting
- Forum home shows each category with its forums, thread and post counts and the latest post, and ends with What's Going On?, active users, statistics, birthdays, the newest member and the icon legend.
- Thread lists show status icons, title, starter, replies, views and last post, with sticky threads, announcements, locked, moved, poll and hot threads, numbered pages, Mark Forum Read and Forum Jump.
- Posting: New Thread, Post Reply and Quick Reply, with a BBCode editor, quotes, Multi-Quote, editing (an edit note shows the post was changed), polls and attachments.
- Thread tags: up to five per thread by default, with suggestions as you type.
Members and the User CP
Members register (with CAPTCHA and email verification by default), sign in with optional Remember Me, and can reset a forgotten password by email. Their User CP includes: Edit Profile, Edit Options, Edit Signature, Edit Avatar, Edit Email and Password, Private Messages, Watched Threads, Bookmarks, Buddy List, Ignore List, Reputation History and their selected skin. Profiles can hold a title, website, location, birthday (with visibility settings) and time zone.
Members can export their personal data, and accounts can be deleted or anonymized. Quick BB gives you these tools; whether your forum meets the privacy laws that apply to you depends on how you run it.
Private messages
The inbox has Inbox, Sent Items and custom folders, with Compose, Reply, Forward, Delete and Mark Read/Unread, a preview button and a storage indicator.
| Group | Default message quota |
|---|---|
| Registered members | 50 |
| Established members | 100 |
| Moderators | 250 |
| Administrators | Unlimited |
Only the people in a conversation can read it. Moderators are not given automatic access to private messages.
Ignore lists
Members can ignore another member from that member's profile or from the User CP. Ignored members' posts are replaced with "This message is hidden because this user is on your ignore list." and a View Post link; post numbering does not change. An ignored member cannot start new private messages with the person who ignored them.
Administrators, Super Moderators and Forum Moderators can never be ignored. If an ignored member is promoted to one of these roles, the ignore is switched off.
Reputation, ranks and subscriptions
- Reputation: positive and optional negative reputation with comments, reputation power and limits, shown as classic pips. Administrators can adjust it.
- Ranks by post count, for example New Member, Junior Member, Member, Senior Member and Veteran Member.
- Watched threads and bookmarks, with notifications by no email, instant email, daily digest or weekly digest.
CAPTCHA, flood control and anti-spam
Registration CAPTCHA
On by default. New members type an 8-character code from an image made on your own server - no outside service. The code can be refreshed, expires, allows a limited number of attempts and can only be used once, and there is an accessible alternative. You can change the length, difficulty, image noise, expiry and attempt limit.
Flood control defaults
| Action | Default |
|---|---|
| Time between replies | 30 seconds |
| Time between new threads | 60 seconds |
| Time between private messages | 60 seconds |
| Time between edits | 10 seconds |
| New threads per hour | 10 |
| Replies per hour | 30 |
| Private messages per hour | 15 |
| External links for new members | Restricted until 5 approved posts |
When a limit is reached the post is not lost: the member sees why, how long to wait, and their text is kept. Every value can be changed, and different usergroups can have different limits.
More tools
Registration rate limits, honeypot fields, email verification, new-member approval, first-post moderation, duplicate post detection, excessive link detection, banned words, banned email domains, IP bans, spam reports and bulk spam clean-up.
Moderation
The Moderator CP lets moderators edit, delete and restore posts; lock, sticky, move, merge and split threads; approve queued posts; work through the report queue; and issue warnings, infractions, suspensions and (where allowed) bans. Each report records the post, who reported it, the reason, status, moderator notes and the action taken. Every action checks the moderator's permissions on the server and is logged.
Advertising
Upload JPEG, PNG, GIF (animated GIFs work) or WebP banners, give each a name and destination address, choose zones, set start and expiry dates and a rotation rule (random, sequential or weighted random), and preview before going live.
| Zone | Default |
|---|---|
| Header (above navigation, below navigation or below breadcrumbs) | On |
| Footer (above the forum footer) | On |
| Left sidebar | Off |
| Right sidebar | Off |
| Between threads | On, every 10 threads |
| Between posts | On, every 5 posts |
| Post redirect page | On, 3-second redirect |
The post redirect page thanks the member for posting, shows an ad and takes them to their post after 3 seconds, with a Continue link. It is hidden from search engines and still works with no ad assigned. Zones with no active ad show nothing. Ads are labelled and never change post numbers, quotes or page links. Statistics show impressions, clicks and an approximate click-through rate.
SEO, tags and sitemaps
| Page | Friendly address |
|---|---|
| Forum | /forums/php-programming/ |
| Thread | /threads/125-how-to-install-php-on-shared-hosting/ |
| Thread page 2 | /threads/125-how-to-install-php-on-shared-hosting/page/2/ |
| Member | /members/42-exampleuser/ |
| Tag | /tags/php-hosting/ |
Old-style addresses such as showthread.php?t=125 keep working and redirect to the friendly address when rewriting is on. If your server can't rewrite addresses, the traditional ones still work.
- Automatic page titles and meta descriptions from your real content, with overrides for forums.
- Canonical URLs that account for old addresses, sorting and tracking parameters and pagination.
- XML sitemaps (split into index files on big forums) listing public forums, threads, populated tag pages and, if you choose, member profiles. Private forums, unapproved or deleted posts, search results and redirect pages are left out.
- Structured data for discussions, replies, breadcrumbs and profiles.
- Thread tags (on, up to 5) and hashtags (off by default). Empty or thin tag pages are kept out of search.
Search and RSS
Search by keyword, thread title, username, forum or date, and show results as threads or posts. Quick links give New Posts, Today's Posts, Unanswered Threads, Watched Threads and Find All Posts or Threads by a member. Results respect permissions. Optional RSS feeds cover the latest public threads and individual public forums.
Email and two-factor sign-in
Enter your SMTP host, port, username, password, TLS setting, sender address and sender name, then use Test Email. Templates cover registration verification, password resets, private message notices, subscription notices, account approval and admin notices.
Two-factor sign-in works with any standard authenticator app (TOTP): scan the QR code or type the setup key, confirm a code and save your recovery codes. It is required for administrators by default, and you can require it for moderators.
Backups and restore
Create a database backup (optionally with uploaded files) and download it securely. Backup history and retention keep things tidy, scheduled backups are supported, and large forums are backed up in chunks to suit shared hosting time limits. Backups are never publicly accessible.
Restoring requires an administrator sign-in and explicit confirmation, checks the file and its compatibility first, and warns you before anything is overwritten. Keep copies of your backups somewhere other than your web host too.
Upgrading
- Make a backup.
- Upload the newer Quick BB files over the old ones.
- Open
upgrade.phpand sign in as an administrator. - Follow the steps. The upgrader checks your PHP version, detects your current version, applies any database changes and keeps a log.
Members, threads, posts, messages, skins, ads, SEO settings and your configuration are preserved, and only one upgrade can run at a time.
Importing an existing forum
Importers bring across members, categories, forums, threads, posts, attachments and basic profile details from supported open-source forum software and from CSV files. Run a dry run first, then import with progress reports; imports map old IDs to new ones, skip duplicates, log errors and can resume if they stop. The importer documentation lists exactly which versions and data are supported.
Passwords are never decrypted. Where the importer supports it, members keep their existing password securely; otherwise they set a new one.
Troubleshooting
install.php shows a failed check
Ask your host to switch to PHP 8.2 or newer or to enable the missing extension (many control panels let you do this yourself). If a folder isn't writable, set its permissions as the installer suggests.
The database test fails
Check the database name and user include any prefix your host adds, that the user has been added to the database with all privileges, and that the host is correct (usually localhost).
Friendly URLs show "not found"
Make sure the .htaccess file was uploaded (turn on "show hidden files" in your file manager). On Nginx, add the supplied rules. You can switch friendly URLs off in the SEO settings in the meantime.
Emails don't arrive
Set up SMTP and send a test email, check spam folders, and make sure your domain's SPF and DKIM records are in place.
A member can't post
They may have hit a flood-control limit (the message tells them how long to wait), be in a group that needs approval, or be restricted from posting links until they have 5 approved posts.
License and support
Your license covers one Quick BB installation on one domain, with free updates. Enter your license key on step 7 of install.php (or later in your forum admin panel) and it is registered to your forum's domain; www.example.com and example.com count as one. Test copies on localhost, private IP addresses or .test / .local domains are never registered, so they don't use up your activation. Licensing never locks features or shows nag screens.
Moving to a new domain? Click Remove License Key on the old forum to free the activation, then enter the key on the new one and click Check License Status. Keep your license key safe - support will ask for it. Lost it? Look it up here.
Lost your download? Get your download link again. Need help? Contact support, and include your Quick BB version, PHP version, what you were doing and the exact message you saw.
