Installation guide and initialization of AnQi CMS

📅 2026-07-18 140

When starting AnQiCMS for the first time, you need to complete the initialization installation, including configuring database connection information, setting the administrator account password, specifying the site name, and other key steps, which is a necessary link before the formal use of the system.


When is initialization needed

The following situations require initialization installation:

Scene Description
First deployment New installation of AnQiCMS
Restore factory settings Reinstall after clearing data

If it passesBaota DockeroraaPanel DockerInstall, the system will automatically complete the initialization (default account admin / password 123456), no manual initialization process is required.


Initialization steps

Step 1: Start AnQiCMS

Ensure that AnQiCMS has started normally (see related deployment instructions from section 2.2 to 2.5).

Step 2: Visit the installation page

Access the domain name of the site in the browser:

http://你的域名

When visiting for the first time, the system detects that it has not been initialized and will automatically jump to the installation interface.

install-bt4.png

Step 3: Fill in the configuration information

The installation interface requires the following information:

Database information

field it must Description
Database host ✅ The MySQL server address is usually127.0.0.1(Local machine) or Docker container name
Database port ✅ MySQL port, default3306
Database username ✅ MySQL username. Recommended to userootor a user with the permission to create a database
Database password ✅ The corresponding MySQL password
Database name ✅ The system will automatically create the database with the specified name, such asanqicmsDo not name it the same as the existing database

Administrator information

field it must Description
Administrator account ✅ Backend login username
Administrator password ✅ Backend login password (recommended to be 8 characters or more, including letters and numbers)

Website information

field it must Description
website address ✅ Website domain, such ashttps://en.anqicms.com(with protocol prefix)

Step 4: Submit installation

ClickSubmitorStart installationButton, the system will:

  1. Check if the database connection is normal
  2. Automatically create the database and table
  3. Write initial configuration data
  4. Create an administrator account
  5. Write default site settings

The installation process usually takes only a few seconds. After the installation is complete, a successful installation prompt will be displayed on the page.


Installation verification

Verify the front

When the browser accesses the home page of the website, the home page content should be displayed normally.

Verify the backend

http://你的域名/system/

Display the backend login page.

Default backend path

http://你的域名/system/

SuggestionAfter installation, promptly in the background:Global SettingsModify the default backend entry path to enhance security.

Default administrator account

账号:安装时设置的管理员账号
密码:安装时设置的管理员密码

Installation failure handling

If an error occurs during installation, common causes and solutions:

Error phenomenon Possible cause Solution
Database connection failed Database host/port/username/password error Check MySQL connection information for correctness
Unable to create database Insufficient database user privileges Use an account with higher privileges (such as root) or manually create the database in advance
Administrator password is invalid Password length or complexity is insufficient Set a password of 8 characters or more, including letters and numbers
port occupied Another program is using port 8001 modifyconfig.jsonofportRestart after setting to other values

Reset installation

If you need to reinitialize (clear all data):

# 1. 停止 AnQiCMS(Linux)
./stop.sh

# 2. 删除数据库(通过 MySQL 命令行或管理工具)
# 3. 删除 data/ 目录下的缓存文件(如有)
rm -rf data/*

# 4. 重新启动 AnQiCMS
./start.sh

# 5. 浏览器访问域名,重新进入安装界面

⚠️Warning: Resetting the installation will delete all data (documents, categories, users, settings, etc.), please back up the database before performing the operation.


❓ After filling in the information on the installation interface and clicking submit, it prompts 'Database connection failed', but my MySQL is indeed running, why?

There are 4 common causes for this problem, please check them one by one:

Reason Verification method Solution
MySQL port is not 3306 On the servermysql -P 3306 -u root -p, if it cannot be connected, it means the port is incorrect Modify the port number on the installation interface or throughnetstat -tlnp \| grep mysqlCheck the actual port
MySQL is only bound to 127.0.0.1 cat /etc/mysql/mysql.conf.d/mysqld.cnf \| grep bind-address It is usually a cloud server issue, but fill in127.0.0.1to solve it
The database user has no permission to create a database Common when connecting with a user other than root Fill in the installation interfacerootaccount, or create the database manually with root in advance
Incorrectly filled in the "Database Host" under Docker environment Cannot use directly inside the container127.0.0.1Access the host machine MySQL changed tohost.docker.internal(or the host's internal network IP)

The simplest method: Manually create an empty database on the server using the root account, then enter the name of this existing database on the installation interface. The installation program will no longer attempt to create a database, thus bypassing the permission issue.

❓ After installation, the page keeps showing loading or a blank screen and cannot be accessed, what should I do?

This situation is usuallyBrowser cacheorNginx configurationissue.

# 第一步:检查程序是否正常运行
curl -I http://127.0.0.1:8001
# 如果返回 200/302,说明 AnQiCMS 正常

# 第二步:检查 Nginx 配置
# 确保 root 指向了 public 目录
# 确保 try_files 规则存在

# 第三步:清除浏览器缓存(一般按 Ctrl+F5 强制刷新)

# 第四步:检查浏览器控制台(F12 → Console)是否有 JS 报错

Also possibleWait a few seconds after installationLet the database write complete, refresh slightly.

❓ Did you fill in the website address incorrectly during installation (such as forgetting to add https://), can it be changed after installation?

It can be changed, no need to reinstall.You can modify it in the background after installation:

  1. Login to the background →setting→Global Settings(/setting/system)
  2. Find the "Website Address" field and change it to the correct address (such ashttps://en.anqicms.com)
  3. Click Save
  4. Background →Tool→Update Cache(/tool/cache)

Entering the wrong website address does not affect the operation of the website, but it may cause the generation of incorrect link addresses for Sitemap, friendship links, etc., so it is recommended to check and correct it immediately after installation.

❓ Is there a strength requirement for the administrator password during initial installation?

Requirements Description
Minimum length At least 6 digits (recommended to be more than 8 digits)
Character combination Recommended to use letters + numbers combination, pure numeric passwords are easy to be cracked by brute force
Special characters Can include special characters (!@#$% etc.)
Common passwords Do not useadmin123/123456/passwordAnd weak passwords

Recommended practiceUse a password manager (such as 1Password, Bitwarden) to generate random passwords and save them in the background. If you forget your password, you can use the "Forgot Password" function on the background login page to reset it through file verification or DNS verification.

Related articles

Deployment of multiple sites on the same server for AnQi CMS

The AnQiCMS supports running multiple independent sites on the same server, each with its own domain name, database, template, and administrator. This chapter details the complete steps and注意事项 for multi-site configuration.Plan one: Multi-site management (recommended) Eligibility: A main AnQiCMS site that is already installed and running. This plan uses the built-in multi-site management feature of AnQiCMS, where all sites share the same AnQiCMS program but run independently.Do not copy the code multiple times. Preparations Have deployed and run a AnQiCMS main site (port 8001) The main station background has Multi-site management Menu permissions (default installed sites have it)

2026-07-18

Source code compilation installation of AnQi CMS

Target audience: Developers who need secondary development, customization features, or whose needs cannot be met by the official binary packages. Difficulty: ⭐⭐⭐⭐ (requires familiarity with GoLang and command line operations) Prerequisites Software version requirements Description GoLang 1.13+ (recommended 1.25+) Compile Go source code Git any version Clone code repository MySQL 5.6.35+ Run database If GoLang has not been installed, please visit https://go.dev/dl/ to download and install.Clone from GitHub (recommended) git clone https://github

2026-07-18

Docker deployment of AnQi CMS

Docker deployment is the fastest installation method for AnQiCMS, suitable for quick experience and testing environments. Docker image address: https://hub.docker.com/r/anqicms/anqicms Method one: Docker command line deployment Suitable for environments where Docker is already installed (any operating system).Quick Start # Pull the latest image docker pull anqicms/anqicms:latest # Run the container docker run -d --name anqicms -p 8001:8001

2026-07-18

Manual deployment of AnQi CMS on the server

Use case: Linux servers without a panel (such as CentOS / Ubuntu), suitable for users familiar with command-line operations.Deployed by downloading the package, configuring Nginx reverse proxy, and MySQL database. Preparations A Linux server (CentOS 7+ or Ubuntu 20.04+) with Nginx and MySQL 5.6.35+ installed (recommended to use the LNMP one-click installation package) A domain name resolved to the server Downloaded AnQiCMS Linux installation package Installation steps Step 1: Download and unzip # Log in to the server ssh

2026-07-18

Installation of AnQi CMS - Troubleshooting common installation issues

Summarize common problems and solutions during the installation of Anqi CMS, covering typical scenarios such as port occupation, database connection failure, blank page, permission error, and missing dependencies, to help users quickly locate and solve problems.Question 1: Port occupied. Phenomenon: After starting AnQiCMS, the website cannot be accessed. Reason: The default port 8001 is occupied by another program.Troubleshooting method: # On Linux / MacOS: Check which process is occupying port 8001 lsof -i:8001 # Example output: # COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME #

2026-07-18

Security CMS MCP Function Details: Built-in 108 tools, allowing AI to directly help you manage your website

AnqiCMS built-in MCP Server, no plugin required to allow Claude, Cursor, and other AI clients to manage the website directly. This article details its working principle, 109 built-in tool categories, three-step configuration method, and typical use cases

2026-09-10

How to troubleshoot slow website inclusion: The configuration sequence of Sitemap generation and active push.

It takes time to determine whether it is due to the incomplete crawling chain or the content itself is not needed. The troubleshooting sequence is: use pseudo-static rules to converge each piece of content into an address form, confirm that the site map can automatically generate and cover new content, initiate link push after the page is indeed accessible, and finally review that robots do not block the key path. Reversing the order will make the proactive push ineffective, and this article provides the judgment criteria for each step and additional handling during the revision period.

2026-10-09

Article status, recycling bin, and backup: the three places that are easy to neglect in the daily operation and maintenance of CMS

The three most easily overlooked aspects of daily CMS operation are the content status chain, time factor, and backup and restore. Formal documents, drafts, pending publication, and recycling station are four states, deleting formal documents only moves them to the recycling station and does not involve physical deletion; scheduled publication makes the online rhythm controllable; backup needs to include static files and verify whether they can be restored. This article provides the state transition sequence, backup strategy judgment, and the use boundary of full-site replacement.

2026-10-09