Install Bizuno

Pick your platform

Bizuno runs anywhere PHP runs. The five guides below cover the platforms people actually install on. If yours isn’t listed, the LAMP guide is the closest fit.

If you just want to try Bizuno on a laptop, the Docker guide is the fastest path. If you’re deploying for real, pick the guide that matches the server you already run.

---

The five guides

1. Docker / Docker Compose — recommended for evaluation and CI → /install/docker One docker compose up -d, a browser URL, and you’re in. Runs on Linux, Windows (Docker Desktop or WSL2), and macOS. Five-minute target.

2. Windows (XAMPP / Laragon) — recommended for Windows developers and hobbyists → /install/windows Two supported stacks. XAMPP is the classic; Laragon is lighter and snappier. Notes on Defender false-positives, port conflicts with IIS/Skype, and Windows path-length gotchas.

3. LAMP (Ubuntu / Debian / RHEL) — recommended for self-hosting on a Linux VPS → /install/lamp The standard stack. Commands for both apt and dnf families. MariaDB or MySQL. Apache or nginx. Let’s Encrypt included.

4. ISPConfig — for admins running ISPConfig 3 control panels → /install/ispconfig Walks through creating the client, site, database, and shell user inside ISPConfig and dropping Bizuno into place. A guide few projects publish.

5. macOS — for Mac developers → /install/macos Two paths: Homebrew (the real one) and MAMP/Laravel Herd (the fast one). Apple-silicon notes included. If you’re not sure, just use Docker.

---

Before you pick

A few things that are true on every platform. Read these once and you can skip the “prerequisites” section in most guides.

• PHP 8.1 or 8.2 is required. 8.3 works in testing but isn’t officially verified yet.
• MariaDB 10.6+ or MySQL 8.0+ is required. Earlier versions may work and are unsupported.
• About 500 MB of disk for the application plus attachments. A real shop’s working set fits comfortably in a few GB.
• A domain name and an SSL certificate are recommended for anything beyond a local test. Let’s Encrypt is free and every guide shows how.
• Backups are your job. Bizuno does not include a cloud backup. The operational checklist covers what to back up and how often.

If any of the above are deal-breakers, stop here — the Docker guide hides them all behind a container.

---

Common troubleshooting (before you open the guide)

Nine out of ten install problems are one of these four:

1. PHP version is too old. Check with php -v at a shell. If it’s below 8.1, upgrade PHP before anything else.
2. A required PHP extension is missing. Bizuno needs mbstring, mysqli (or pdo_mysql), gd, curl, xml, zip, and intl. Your platform’s guide has the install command.
3. Database credentials are wrong. Bizuno fails with a clear “cannot connect” message when this happens. Re-check user, password, and host (usually localhost or 127.0.0.1, not the server’s public IP).
4. The web server can’t write to /data/. Permission errors on first login are always this. Your platform’s guide has the right chown/chmod.

If you’ve checked all four and it’s still broken, open a thread in Install & Setup with your platform and the exact error.

---

Where to go after install

1. Log in with the admin account you created.
2. Work through the Getting Started doc category — seven short articles, about 20 minutes.
3. Load the demo data if you want a sandbox to click around in (any install guide shows how).
4. If something goes wrong, the community forum is the fastest place to ask.

---

Dual-maintenance note (for repo readers)

Every guide on this site is also published as a Markdown file in the bizuno-docs GitHub repo. The site and the repo are kept in sync; the Markdown file in the repo is the source of truth. If the two ever disagree, the repo wins — and please open an issue.

Each guide is stamped with the Bizuno version it’s been verified against and the date of last verification. If that date is more than two releases behind the current Bizuno version, the guide is stale and you should ask on the forum before trusting it end-to-end.