cat /etc/os-release | head -2

PRETTY_NAME="Ubuntu 22.04.5 LTS"
NAME="Ubuntu"

node -v; pnpm -v; nginx -v; mariadb --version; redis-server -v

v18.20.8
9.0.5
nginx version: nginx/1.18.0 (Ubuntu)
mariadb  Ver 15.1 Distrib 10.6.23-MariaDB, for debian-linux-gnu (x86_64) using  EditLine wrapper
Redis server v=6.0.16 sha=00000000:0 malloc=jemalloc-5.2.1 bits=64 build=d6ed09173b889769

grep -A3 '"engines"' /opt/bigcapital/package.json

  "engines": {
    "node": "16.x || 17.x || 18.x"
  },

apt-get update && apt-get install -y git curl build-essential nginx mariadb-server redis-server

git is already the newest version (1:2.34.1-1ubuntu1.18).
nginx is already the newest version (1:18.0-6ubuntu14.21).
mariadb-server is already the newest version (1:10.6.23-0ubuntu0.22.04.1).
redis-server is already the newest version (5:6.0.16-1ubuntu1.2).
0 upgraded, 0 newly installed, 0 to remove and 3 not upgraded.

curl -fsSL https://deb.nodesource.com/setup_18.x | bash -

3 packages can be upgraded. Run 'apt list --upgradable' to see them.
2026-10-22 18:04:01 - Repository configured successfully.
2026-10-22 18:04:01 - To install Node.js, run: apt install nodejs -y
2026-10-22 18:04:01 - You can use N|solid Runtime as a node.js alternative
2026-10-22 18:04:01 - To install N|solid Runtime, run: apt install nsolid -y

apt-get install -y nodejs

nodejs is already the newest version (18.20.8-1nodesource1).
0 upgraded, 0 newly installed, 0 to remove and 3 not upgraded.

npm install -g pnpm@9

1 package is looking for funding
  run `npm fund` for details

node -v; pnpm -v

v18.20.8
9.0.5

systemctl enable --now mariadb redis-server

Synchronizing state of redis-server.service with SysV service script with /lib/systemd/systemd-sysv-install.
Executing: /lib/systemd/systemd-sysv-install enable redis-server
Synchronizing state of mariadb.service with SysV service script with /lib/systemd/systemd-sysv-install.
Executing: /lib/systemd/systemd-sysv-install enable mariadb

systemctl is-active mariadb redis-server; redis-cli ping

active
active
PONG

mysql -u root <<'EOF'
CREATE DATABASE bigcapital_system CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'bigcapital'@'localhost' IDENTIFIED BY 'q1w2e3r4';
GRANT ALL PRIVILEGES ON `bigcapital%`.* TO 'bigcapital'@'localhost';
FLUSH PRIVILEGES;
EOF

mysql -u root -e "SHOW GRANTS FOR 'bigcapital'@'localhost';"

Grants for bigcapital@localhost
GRANT USAGE ON *.* TO `bigcapital`@`localhost` IDENTIFIED BY PASSWORD '*0971389F8E7F1AEB999104BDA7A0FA145087F348' WITH GRANT OPTION
GRANT ALL PRIVILEGES ON `bigcapital%`.* TO `bigcapital`@`localhost`

useradd -r -m -d /opt/bigcapital-user -s /bin/bash bigcapital
cd /opt
curl -fsSL -o bigcapital-v0.25.44.tar.gz https://codeload.github.com/bigcapitalhq/bigcapital/tar.gz/refs/tags/v0.25.44

ls -lh /opt/bigcapital-v0.25.44.tar.gz

-rw-r--r-- 1 root root 8.7M Oct 22 18:06 bigcapital-v0.25.44.tar.gz

cd /opt && tar xzf bigcapital-v0.25.44.tar.gz && mv bigcapital-0.25.44 bigcapital && rm bigcapital-v0.25.44.tar.gz

ls /opt/bigcapital | head -8; du -sh /opt/bigcapital

AGENTS.md
CHANGELOG.md
CONTRIBUTING.md
DISCLAIMER
LICENSE
README.md
bin
commitlint.config.js
72M     /opt/bigcapital

cat > /opt/bigcapital/.env <<'EOF'
APP_JWT_SECRET=ptsviuCqijT6S/3v4lM+ueLFJZiVwANRwmcZ54nWmVkLpTNrZlUK9ZDKPCnksZPc
DB_HOST=127.0.0.1
DB_USER=bigcapital
DB_PASSWORD=q1w2e3r4
DB_CHARSET=utf8
SYSTEM_DB_NAME=bigcapital_system
TENANT_DB_NAME_PERFIX=bigcapital_tenant_
BASE_URL=http://localhost
SIGNUP_DISABLED=false
SIGNUP_EMAIL_CONFIRMATION=false
EOF

chown -R bigcapital:bigcapital /opt/bigcapital

sudo -u bigcapital bash -c 'cd /opt/bigcapital && pnpm install'

Scope: all 7 workspace projects
Lockfile is up to date, resolution step is skipped
Progress: resolved 1, reused 0, downloaded 0, added 0
Packages: +2864
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Progress: resolved 2864, reused 1686, downloaded 0, added 0

. prepare: fatal: not a git repository (or any of the parent directories): .git
. prepare: husky - git command not found, skipping install
. prepare: Done
Done in 5.6s

sudo -u bigcapital bash -c 'cd /opt/bigcapital && pnpm build:server'

> bigcapital-monorepo@ build:server /opt/bigcapital
> lerna run build --scope "@bigcapital/server" --scope "@bigcapital/utils" --scope "@bigcapital/pdf-templates" --scope "@bigcapital/email-components"

lerna notice cli v8.1.3
lerna info versioning independent
lerna notice filter including ["@bigcapital/server","@bigcapital/utils","@bigcapital/pdf-templates","@bigcapital/email-components"]

 Lerna (powered by Nx)   Successfully ran target build for 4 projects

sudo -u bigcapital bash -c 'cd /opt/bigcapital/packages/server && node dist/cli.js system:migrate:latest'

Batch 1 run: 31 migrations

sudo -u bigcapital bash -c 'cd /opt/bigcapital/packages/server && node dist/cli.js tenants:migrate:latest'

All tenants are migrated.

mysql -u bigcapital -pq1w2e3r4 -e "SELECT COUNT(*) AS system_tables FROM information_schema.tables WHERE table_schema='bigcapital_system';"

system_tables
17

sudo -u bigcapital bash -c 'cd /opt/bigcapital && pnpm build:webapp'

> bigcapital-monorepo@ build:webapp /opt/bigcapital
> lerna run build --scope "@bigcapital/webapp" --scope "@bigcapital/utils" --scope "@bigcapital/pdf-templates" --scope "@bigcapital/sdk-ts"

lerna notice cli v8.1.3
lerna info versioning independent
lerna notice filter including ["@bigcapital/webapp","@bigcapital/utils","@bigcapital/pdf-templates","@bigcapital/sdk-ts"]

 Lerna (powered by Nx)   Successfully ran target build for 4 projects

sudo -u bigcapital bash -c 'cd /opt/bigcapital && nohup node packages/server/dist/main.js > /tmp/bigcapital-server.log 2>&1 &'

curl -s http://127.0.0.1:3000/api/users

{"message":"Unauthorized","statusCode":401}

curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:3000/swagger

200

pkill -f 'packages/server/dist/main.js'

cat > /etc/systemd/system/bigcapital-server.service <<'EOF'
[Unit]
Description=Bigcapital API Server (NestJS)
After=network.target mariadb.service redis-server.service
Wants=mariadb.service redis-server.service

[Service]
Type=simple
User=bigcapital
WorkingDirectory=/opt/bigcapital
ExecStart=/usr/bin/node /opt/bigcapital/packages/server/dist/main.js
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload && systemctl enable --now bigcapital-server

systemctl status bigcapital-server --no-pager | head -10

● bigcapital-server.service - Bigcapital API Server (NestJS)
     Loaded: loaded (/etc/systemd/system/bigcapital-server.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2026-10-22 17:51:24 UTC; 6s ago
   Main PID: 10854 (node)
      Tasks: 7 (limit: 94371)
     Memory: 190.1M
        CPU: 2.232s

journalctl -u bigcapital-server --no-pager | grep Started | tail -1

Oct 22 17:51:24 bigcapital-src systemd[1]: Started Bigcapital API Server (NestJS).

cd /opt
tar --exclude='bigcapital/.git' --exclude='bigcapital/e2e' --exclude='bigcapital/.env' -czf /tmp/bigcapital-v0.25.44-dist.tar.gz bigcapital

ls -lh /tmp/bigcapital-v0.25.44-dist.tar.gz

-rw-r--r-- 1 bigcapital bigcapital 281M Oct 22 17:55 /tmp/bigcapital-v0.25.44-dist.tar.gz

du -sh /opt/bigcapital

1.5G    /opt/bigcapital

scp /tmp/bigcapital-v0.25.44-dist.tar.gz root@<目标服务器IP>:/tmp/
scp /opt/bigcapital/.env root@<目标服务器IP>:/tmp/bigcapital.env

useradd -r -m -d /opt/bigcapital-user -s /bin/bash bigcapital
mkdir /opt/offline-extract && cd /opt/offline-extract && tar xzf /tmp/bigcapital-v0.25.44-dist.tar.gz && mv bigcapital /opt/bigcapital-offline && cd /opt && rmdir offline-extract

cp /tmp/bigcapital.env /opt/bigcapital-offline/.env
chown -R bigcapital:bigcapital /opt/bigcapital-offline

du -sh /opt/bigcapital-offline && ls /opt/bigcapital-offline/packages/server/dist/main.js /opt/bigcapital-offline/packages/webapp/dist/index.html

1.5G    /opt/bigcapital-offline
/opt/bigcapital-offline/packages/server/dist/main.js
/opt/bigcapital-offline/packages/webapp/dist/index.html

sudo -u bigcapital bash -c 'cd /opt/bigcapital-offline && PORT=3100 nohup node packages/server/dist/main.js > /tmp/bigcapital-offline.log 2>&1 &'

curl -s http://127.0.0.1:3100/api/users

{"message":"Unauthorized","statusCode":401}

systemctl restart bigcapital-server   # 重启
systemctl stop bigcapital-server      # 停止
systemctl status bigcapital-server    # 状态
journalctl -u bigcapital-server -f    # 跟踪日志

cat > /etc/nginx/sites-available/bigcapital.conf <<'EOF'
server {
    listen 80 default_server;
    server_name _;

    root /opt/bigcapital/packages/webapp/dist;
    index index.html;

    # API 反向代理：转发到本机 3000 端口的 Bigcapital Server
    location /api/ {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        client_max_body_size 25m;
    }

    # 前端单页应用：所有未命中路径回退到 index.html
    location / {
        try_files $uri $uri/ /index.html;
    }
}
EOF
ln -sf /etc/nginx/sites-available/bigcapital.conf /etc/nginx/sites-enabled/bigcapital.conf

nginx -t && systemctl reload nginx

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1/

200

curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1/api/users

401

systemctl stop bigcapital-server
cd /opt && mv bigcapital bigcapital-v0.25.42-bak

cd /opt && tar xzf bigcapital-v0.25.44.tar.gz && mv bigcapital-0.25.44 bigcapital
cp bigcapital-v0.25.42-bak/.env bigcapital/.env
chown -R bigcapital:bigcapital /opt/bigcapital

sudo -u bigcapital bash -c 'cd /opt/bigcapital && pnpm install && pnpm build:server && pnpm build:webapp'

Done in 52.1s

 Lerna (powered by Nx)   Successfully ran target build for 4 projects

 Lerna (powered by Nx)   Successfully ran target build for 4 projects

sudo -u bigcapital bash -c 'cd /opt/bigcapital/packages/server && node dist/cli.js system:migrate:latest && node dist/cli.js tenants:migrate:latest'

Batch 2 run: 1 migrations
-------------------
All tenants are migrated.

systemctl start bigcapital-server

curl -s -o /dev/null -w 'api:%{http_code} ' http://127.0.0.1/api/users && curl -s -o /dev/null -w 'web:%{http_code}\n' http://127.0.0.1/

api:401 web:200

systemctl stop bigcapital-server
cd /opt && mv bigcapital bigcapital-v0.25.44-broken && mv bigcapital-v0.25.42-bak bigcapital
systemctl start bigcapital-server

Error: /tmp/nx-native-file-cache/2922472c08696a6abca9e97b97971d04f6f076227182e3ba025d610baa410592/19.0.7-nx.linux-x64-gnu.node: failed to map segment from shared object
  code: 'ERR_DLOPEN_FAILED'
 ELIFECYCLE  Command failed with exit code 1.

mount | grep ' /tmp '

tmpfs on /tmp type tmpfs (rw,nosuid,nodev,noexec,relatime,inode64)

mount -o remount,exec /tmp
rm -rf /tmp/nx-native-file-cache

.../.pnpm/nx@19.0.7/node_modules/nx postinstall:   code: 'EACCES',
.../.pnpm/nx@19.0.7/node_modules/nx postinstall:   path: '/tmp/nx-native-file-cache/329f7b2ebd261c758970c346f1c8875ad8e09cb9d0c868adcfc591265a0cffa3'

rm -rf /tmp/nx-native-file-cache

Error: ER_BAD_DB_ERROR: Unknown database 'bigcapital_system'

Error: ENOENT: no such file or directory, scandir '/opt/bigcapital/src/database/system/migrations'

cd /opt/bigcapital/packages/server && node dist/cli.js system:migrate:latest

It is highly recommended to use a minimum Redis version of 6.2.0

{"message":"password must be longer than or equal to 10 characters","statusCode":400}

# 1. 停止并移除应用服务
systemctl stop bigcapital-server
systemctl disable bigcapital-server
rm -f /etc/systemd/system/bigcapital-server.service
systemctl daemon-reload

# 2. 移除 Nginx 站点配置
rm -f /etc/nginx/sites-enabled/bigcapital.conf /etc/nginx/sites-available/bigcapital.conf
systemctl reload nginx

# 3. 删除数据库与账号（会连带删除全部财务数据，务必先确认备份）
mysql -u root -e 'DROP DATABASE IF EXISTS bigcapital_system;'
mysql -u root -e "SHOW DATABASES LIKE 'bigcapital_tenant%';"   # 先核对要删除的租户库
mysql -u root -e "DROP DATABASE IF EXISTS bigcapital_tenant_xxxx;"
mysql -u root -e "DROP USER IF EXISTS 'bigcapital'@'localhost';"

# 4. 删除应用目录与离线包
rm -rf /opt/bigcapital /opt/bigcapital-offline /opt/bigcapital-v0.25.42-bak /tmp/bigcapital-v0.25.44-dist.tar.gz

# 5. （可选）卸载不再需要的依赖组件
apt-get purge -y mariadb-server redis-server nginx