Installation overview
Spend 30 seconds picking a method. Picking the wrong one costs a lot of detours.
Which one should I use?
| Your situation | Recommended | Roughly |
|---|---|---|
| You have a Linux server and want a GUI to manage it | aaPanel | 15 min |
| You are comfortable with a terminal, or want one command | Docker | 3 min |
| You are on a Windows PC or Windows server | Windows | 10 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 aaPanel and manual routes need this section. Docker does not — everything is baked into the image.
| Item | Requirement |
|---|---|
| PHP | 8.0 or newer (8.2 recommended) |
| MySQL | 5.7 or newer (MariaDB 10.3+ works too) |
| URL rewrite | Required — see rewrite rules |
| Redis | Optional, 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
bcmathis 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. aaPanel's PHP already ships withbcmath, so there is nothing to install there. On a manual install, make sure it is enabled.
Directories that must be writable
| Directory | Used for |
|---|---|
config | Database configuration |
runtime | Cache and logs |
kernel/Install | Installation and upgrades |
assets/cache | Static asset cache |
In aaPanel, 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
- The admin panel is at
https://your-domain/admin - Log in with the account you created during installation
- Continue with the quick start and sell your first product
Other ways to get the source
If you already know what you are doing:
composer create-project lizhipay/acg-faka- GitHub: https://github.com/lizhipay/acg-faka
- Zip download (useful where GitHub is slow): https://faka.wiki/download.php
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.