Skip to content
v8.4 · est. 2003
/docs/ · reference · v8.4 · manual.md
[ 2025-06-14 · 14:22 UTC ] posted by: kuro_admin subject:

IchigoBBS Documentation_

The reference manual for the v8.4 series — installation, administration, the plugin API, and migration paths from vBulletin, phpBB, XenForo, MyBB, and Discourse. Maintained continuously since 2003. No threads expire.

  • latestv8.4 — released Q2 2025
  • licenseBSD-2-Clause (core engine)
  • min. stackPHP 8.1 · MariaDB 10.6 · 512 MB RAM
  • maintained by14 core · 240+ contributors
02/table of contents

Four doors into the manual.

Pick where you need to start. Each pillar is a self-contained guide — you don't have to read the others to ship a working forum.

  1. 01
    pillar 01

    Install

    Spin up IchigoBBS on any $5/mo VPS in under nine minutes. Covers the reference stack (Nginx + PHP-FPM + MariaDB), Docker, the one-click Hetzner image, and post-install hardening.

    • 01.1 — System requirements
    • 01.2 — The 9-minute install
    • 01.3 — Docker compose profile
    • 01.4 — First-admin checklist
    open install guide →
  2. 02
    pillar 02

    Administer

    Day-200 operations: moderation queues, ACLs, the spam-filter pipeline, backups, and the long, dull work of keeping a community healthy. Written by admins who run IchigoBBS themselves.

    • 02.1 — Roles & permissions
    • 02.2 — Moderation queue
    • 02.3 — Backups & restores
    • 02.4 — The spam pipeline
    open admin guide →
  3. 03
    pillar 03

    Extend

    The plugin API, hooks, the registry of 1,860+ community-vetted extensions, and a worked example of shipping a plugin from hello.php to a tagged release.

    • 03.1 — Hook reference
    • 03.2 — Your first plugin
    • 03.3 — Publishing to the registry
    • 03.4 — Themes & templates
    browse the registry →
  4. 04
    pillar 04

    Migrate

    One-click imports from vBulletin, phpBB, XenForo, MyBB, and Discourse. The migration toolkit keeps user hashes, private messages, attachment blobs, and thread read-states intact. Average run: under 17 minutes.

    • 04.1 — Pre-flight checklist
    • 04.2 — phpBB & vBulletin paths
    • 04.3 — Discourse JSON import
    • 04.4 — Verifying the import
    open migration guide →
03/release ledger

Twenty-two years of shipping, on the record.

Every IchigoBBS release is dated, signed, and mirrored. This strip is the four most recent — the full changelog runs back to spring 2003.

version date changelog tag
v8.4.1 2025-05-22 Patch: PHP 8.4 deprecation sweep, fix for ActivityPub inbox retry queue, restore from S3-compatible blob store hardened against partial-write corruption. stable
v8.4.0 2025-03-11 Federation milestone: built-in ActivityPub bridge for outbound Mastodon reach; new plugin registry v3 API; rebuilt search index for sub-50 ms thread queries on 10M-post forums. stable
v8.3.2 2024-11-04 Admin UX pass: redesigned moderation queue, bulk-action CLI, IP-range ban importer. Twelve community PRs merged. Migration toolkit gained Discourse 2.9 JSON compatibility. stable
v8.3.0 2024-06-18 Threaded subscriptions, per-board notification digests, the first cut of the OAuth2/OIDC provider so IchigoBBS can act as the identity layer for sibling community apps. stable
Full ledger: 87 releases, spring 2003 → present. Mirrored by the Internet Archive's community-software preservation list since 2019. view the full changelog →
04/editorial note

How this manual is written.

The IchigoBBS docs are not a marketing site. They are written by the same fourteen people who answer support threads, merge the patches, and run their own forums on weekend nights. We try to keep them terse, example-first, and honest about what is broken.

A page in this manual opens with the shortest possible statement of what it covers, then drops you into a worked example. We don't pad pages with screenshots of the admin UI when a command does the same job. When a feature has a sharp edge — a rate limit, an order-of-operations quirk, a server setting that will silently corrupt attachments — we name it in the same paragraph as the happy path. If a recipe in the docs is wrong, you'll find a correction note at the top of the page, dated, with the author handle of the person who wrote the fix.

We follow three small rules. First, no marketing prose — the docs never tell you why IchigoBBS is great, because the changelog and the install guide do that on their own. Second, no hidden assumptions — every command assumes the reference stack, but every page also calls out where it doesn't. Third, no abandoned sections: pages are removed, not left to rot. If a hook is deprecated, the page is rewritten as a migration recipe and the old path returns a 301.

The docs are version-stamped (you're reading the v8.4 reference) and they are forkable on GitHub. If you spot something we missed, open a PR against ichigobbs/docs — we merge doc PRs the same week, usually the same day.

— the IchigoBBS core team

05/next step

Read the manual.
Then spin up a forum.

You just walked the docs index. The shortest path from here to a running forum is the one-click install, or — if you want to poke at it first — the free hosted sandbox at talk.ichigobbs.net, which has been online continuously for eleven years.

  • install time~ 9 min on the reference stack
  • migration timeavg. 17 min from phpBB / vBulletin / Discourse
  • costfree core engine, BSD-2-Clause, no per-seat fees
  • if you get stuck[email protected] · 14 maintainers worldwide