Skip to content

Install on Windows

Setting up PHP, MySQL and URL rewriting on Windows is painful. Use Docker instead — it is all mouse clicks, with no commands to type.

If you only want to try the software on your own PC, Docker is by far the easiest route. For a real, public-facing store, put it on a Linux server — see BaoTa panel.

Step 1: Install Docker Desktop

  1. Go to https://www.docker.com/products/docker-desktop/ and download the Windows build
  2. Run the installer and accept the defaults
  3. If it offers to install WSL 2, say yes — it handles that itself
  4. Reboot when it finishes
  5. Open Docker Desktop and wait for the icon in the bottom-left to turn green

Requires 64-bit Windows 10 version 2004 or newer, or Windows 11. Older systems cannot run it — use BaoTa panel instead.

If you see "WSL 2 installation is incomplete", open PowerShell as administrator, run wsl --update, and reboot.

Step 2: Pull the image

In the search box at the top of Docker Desktop, type:

ghcr.io/lizhipay/acg-faka

and choose Pull. The image is about 265 MB, so a minute or two depending on your connection.

If the search finds nothing, switch the source from Docker Hub to the full image address, or just use the command-line method in step 4 — one command and it is done.

Step 3: Run the container

Find the image under Images, click Run, expand Optional settings, and fill it in like this:

Running a container in Docker DesktopRunning a container in Docker Desktop
#ValueNotes
ghcr.io/lizhipay/acg-faka:latestImage name, usually pre-filled
fakaContainer name — anything you like, it just makes it easy to find
Host port 8080The 80 on the right is the port inside the container. Do not change it
acg_data/dataData volume. Without it, deleting the container deletes your data
Click RunOff it goes

Here is why ③ looks the way it does:

Port mappingPort mapping

The left side is the port you type in the browser; the right side is the port inside the container, which is always 80.

On Windows, port 80 is often already taken by IIS or something else, which is why 8080 is suggested here.

Step 4: Open the site

In your browser:

http://localhost:8080

Give it about 20 seconds — the container initialises its database first — then refresh and the installer appears.

Leave the database step blank and click next; the bundled database is already set up.

Once you have created your admin account, the panel is at:

http://localhost:8080/admin

Prefer the command line?

One line in PowerShell does exactly the same thing:

bash
docker run -d --name faka -p 8080:80 -v acg_data:/data --restart unless-stopped ghcr.io/lizhipay/acg-faka:latest

Letting other people reach it

localhost only works on your own machine. To let others in:

  1. Allow port 8080 through Windows Firewall
  2. Others on your LAN use http://your-lan-ip:8080
  3. For access from the internet you need a public IP or a tunnelling service

Do not run a real store on a home PC. Power cuts, reboots and the lack of a public IP will all bite you. Get a server and use BaoTa panel or Docker.

Day-to-day operations

All of these are mouse clicks on the Containers page in Docker Desktop:

To do thisDo that
View logsClick the container name, open the Logs tab
RestartRestart button on the right of the row
Stop / startStop / play button on the right of the row
Shell insideClick the container name, open the Exec tab

Can I do it without Docker?

Yes, but you are on your own:

  1. Install phpstudy or WampServer with PHP 8.0 or newer
  2. Enable bcmath, gd, curl and zip (bcmath is mandatory — without it the program throws a fatal error)
  3. Extract the source into your web root
  4. Configure URL rewriting — IIS rules for IIS, nothing to do for Apache, nginx rules for nginx
  5. Open the site and run the installer

This is considerably more work than Docker and much harder to debug. Not recommended for beginners.

Released under the MIT License