Skip to content

Installation overview

Spend 30 seconds picking a method. Picking the wrong one costs a lot of detours.

Which one should I use?

Your situationRecommendedRoughly
You have a Linux server and want a GUI to manage itBaoTa panel15 min
You are comfortable with a terminal, or want one commandDocker3 min
You are on a Windows PC or Windows serverWindows10 min

When in doubt, use Docker. It brings its own database and Redis, so you do not have to install anything, and it works the moment it starts.

All three produce exactly the same application. Only the way you get it running differs.

Requirements

Only the BaoTa and manual routes need this section. Docker does not — everything is baked into the image.

ItemRequirement
PHP8.0 or newer (8.2 recommended)
MySQL5.7 or newer (MariaDB 10.3+ works too)
URL rewriteRequired — see rewrite rules
RedisOptional, but makes a very noticeable difference — see performance tuning

Required PHP extensions

The first step of the installer checks your environment and lists anything missing. The list is:

gd, curl, pdo, pdo_mysql, date, json, session, zip, bcmath

bcmath is the one people forget. Every money calculation goes through it — orders, top-ups, sub-store settlement, product pricing. Without it the program throws a fatal error rather than merely running slowly or missing a feature. In BaoTa, tick bcmath under PHP → Install extensions.

Directories that must be writable

DirectoryUsed for
configDatabase configuration
runtimeCache and logs
kernel/InstallInstallation and upgrades
assets/cacheStatic asset cache

In BaoTa, setting the whole site directory's owner to www covers all of them. The installer also lists non-writable directories up front, so you do not discover the problem only after clicking "Install".

After installing

  1. The admin panel is at https://your-domain/admin
  2. Log in with the account you created during installation
  3. Continue with the quick start and sell your first product

Other ways to get the source

If you already know what you are doing:

bash
composer create-project lizhipay/acg-faka

Both of these give you source only. You still need PHP, MySQL and URL rewriting configured before you can open the site and run the installer.

Released under the MIT License