Install with BaoTa panel

For anyone with a Linux server who wants a GUI. About 15 minutes.

For something quicker, see Docker — three minutes, and no database to install.

Step 1: Install the panel

Recommended systems: CentOS 7+, Debian 11+, Ubuntu 20.04+. SSH into the server and run the one-line installer for your system from https://www.bt.cn/new/download.html.

When it finishes it prints the panel URL, username and password. Write them down.

Step 2: Install the runtime

The first login offers a recommended bundle. Choose LNMP, then pick versions:

Component	Choose
Nginx	Any version
MySQL	5.7 or newer
PHP	8.0 or newer, ideally 8.2

Click install and let it run — about 10 minutes.

Step 3: Install bcmath (do not skip this)

BaoTa does not install bcmath by default, and every money calculation in the program depends on it. Without it you get a blank page and a fatal error.

1. App Store → find your PHP version → Settings
2. Open the Install extensions tab
3. Find bcmath and install it

While you are there, confirm gd, curl, zip and pdo_mysql are present — BaoTa usually includes them.

The first step of the installer checks your environment and lists anything missing, so you can refresh and re-check after installing.

Step 4: Create the site

1. Website → Add site
2. Enter your domain (or the server IP if you do not have one yet)
3. Under Database, choose MySQL. It generates a username and password — write them down
4. Choose the PHP version you installed
5. Submit

Step 5: Upload the source

1. Download the archive from https://faka.wiki/download.php (or straight from GitHub if that is fast for you)
2. In BaoTa → Files → open the site root, usually /www/wwwroot/your-domain
3. Upload the archive and right-click → Extract
4. If extraction produced an extra folder (for example acg-faka-main), go inside, select everything and move it up so that index.php sits directly in the site root

You should be able to see index.php, app, kernel and config directly in the root.

Step 6: Configure URL rewriting

Skip this and only the home page works — every link 404s.

Website → click your site → URL rewrite, paste the whole nginx rewrite block, and save.

On Apache there is nothing to do; the .htaccess in the project root already covers it.

Step 7: Fix directory permissions

Website → your site → Site directory → set the owner to www. Or in Files, right-click the site root → Permissions → owner www, ticking "apply to subdirectories".

The program needs to write to four places: config, runtime, kernel/Install, assets/cache.

Step 8: Run the installer

Open your domain in a browser:

1. Environment check — install extensions or fix permissions for anything with a red cross
2. Database — the name, user and password BaoTa generated in step 4; host is 127.0.0.1
3. Admin account — the email and password for the admin panel
4. Install, and wait for it to finish

The panel is then at https://your-domain/admin.

Next

• Domains, HTTPS and multiple domains: see domains and HTTPS certificates
• Make it fast: performance tuning — installing Redis makes a dramatic difference
• Start using it: quick start

Common problems

Symptom	Cause
Only the home page loads, everything else 404s	URL rewriting not configured — back to step 6
Blank page / 500	Usually missing bcmath — back to step 3. Also check runtime.log in the site root
Installer says a directory is not writable	Permissions — back to step 7
Cannot connect to the database	Host should be 127.0.0.1, with the credentials BaoTa generated

See also troubleshooting.