# 确认系统版本
lsb_release -a

No LSB modules are available.
Distributor ID:	Ubuntu
Description:	Ubuntu 22.04.5 LTS
Release:	22.04
Codename:	jammy

npm view lowdefy version
npm view lowdefy dist-tags --json
npm view lowdefy engines --json

7.2.0
{
  "alpha": "4.0.0-alpha.37",
  "rc": "4.0.0-rc.12",
  "latest": "7.2.0",
  "latest-6": "6.2.2",
  "experimental": "0.0.0-experimental-20261027111447"
}
{
  "node": ">=24"
}

sudo apt-get update
sudo apt-get install -y curl gnupg ca-certificates

curl -fsSL https://deb.nodesource.com/setup_24.x -o /tmp/nodesource_setup.sh
sudo bash /tmp/nodesource_setup.sh
sudo apt-get install -y nodejs

Get:6 https://deb.nodesource.com/node_24.x nodistro/main amd64 Packages [9819 B]
Fetched 22.0 kB in 2s (12.1 kB/s)
2026-10-27 16:56:25 - Repository configured successfully.
2026-10-27 16:56:25 - To install Node.js, run: apt install nodejs -y

Get:1 https://deb.nodesource.com/node_24.x nodistro/main amd64 nodejs amd64 24.22.1-1nodesource1 [39.5 MB]
Fetched 39.5 MB in 11s (3444 kB/s)
Selecting previously unselected package nodejs.
Setting up nodejs (24.22.1-1nodesource1) ...

node -v
npm -v
which node npm

v24.22.1
11.19.1
/usr/bin/node
/usr/bin/npm

sudo corepack enable
pnpm --version

12.15.0

sudo npm install -g lowdefy@7.1.0

added 208 packages in 2m

62 packages are looking for funding
  run `npm fund` for details
npm notice New major version of npm available! 11.19.1 -> 12.2.1

lowdefy --version
which lowdefy
lowdefy --help

7.1.0
/usr/bin/lowdefy

Usage: lowdefy [options] [command]

Lowdefy CLI

Options:
  -v, --version              output the version number
  -h, --help                 display help for command

sudo pnpm add -g lowdefy@7.1.0

Error: ERR_PNPM_GLOBAL_BIN_DIR_NOT_IN_PATH

  × The configured global bin directory "/root/.local/share/pnpm/bin" is not
  │ in PATH
  help: Run "pnpm setup" to update your shell configuration.

export PNPM_HOME=/root/.local/share/pnpm
export PATH=$PNPM_HOME/bin:$PATH
pnpm add -g lowdefy@7.1.0

dependencies:
+ lowdefy 7.1.0

Done in 2.2s using pnpm v12.15.0

$PNPM_HOME/bin/lowdefy --version
ls -l $PNPM_HOME/bin

7.1.0
total 16
-rwxr-xr-x 1 root root 2830 Oct 27 17:10 pn
-rwxr-xr-x 1 root root 2981 Oct 27 17:10 pnpm
-rwxr-xr-x 1 root root 2838 Oct 27 17:10 pnpx
-rwxr-xr-x 1 root root 2836 Oct 27 17:10 pnx

cd /tmp
pnpx lowdefy@7.1.0 --version

dependencies:
+ lowdefy 7.1.0

7.1.0
Done in 6.7s using pnpm v12.15.0

curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \
  sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg --dearmor
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | \
  sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
sudo apt-get update
sudo apt-get install -y mongodb-org

Adding user `mongodb' to group `mongodb' ...
Adding user mongodb to group mongodb
Done.
Setting up mongodb-org-tools (7.0.45) ...
Setting up mongodb-org-database (7.0.45) ...
Setting up mongodb-org (7.0.45) ...
Created symlink /etc/systemd/system/multi-user.target.wants/mongod.service → /lib/systemd/system/mongod.service.

sudo systemctl enable mongod
sudo systemctl start mongod
systemctl is-active mongod
mongosh --quiet --eval "db.runCommand({ping:1})"

active
{ ok: 1 }

sudo mkdir -p /opt/lowdefy-demo
cd /opt/lowdefy-demo
lowdefy init

∙ Running 'lowdefy init'.
∙ Initializing Lowdefy project.
∙ Created 'lowdefy.yaml'.
∙ Created '.gitignore'.
✔ Project initialized.

ls -la
cat .gitignore

total 20
drwxr-xr-x 3 root root 4096 Oct 27 16:59 .
drwxr-xr-x 3 root root 4096 Oct 27 16:59 ..
-rw-r--r-- 1 root root   16 Oct 27 16:59 .gitignore
drwxr-xr-x 2 root root 4096 Oct 27 16:59 .lowdefy
-rw-r--r-- 1 root root 1440 Oct 27 16:59 lowdefy.yaml
.lowdefy/**
.env

lowdefy: 7.1.0
name: Lowdefy Demo
version: 0.1.0
slug: lowdefy-demo
description: Lowdefy 安装验证应用

cli:
  port: 3000
  disableTelemetry: true

config:
  homePageId: home

connections:
  - id: demo_mongo
    type: MongoDBCollection
    properties:
      databaseUri:
        _secret: MONGODB_URI
      databaseName: lowdefy_demo
      collection: visits
      write: true

pages:
  - id: home
    type: PageHeaderMenu
    properties:
      title: 访问记录
    requests:
      - id: insert_visit
        type: MongoDBInsertOne
        connectionId: demo_mongo
        properties:
          doc:
            created_at:
              _date: now
      - id: get_visits
        type: MongoDBFind
        connectionId: demo_mongo
        properties:
          query: {}
    events:
      onMount:
        - id: log_visit
          type: Request
          params: insert_visit
        - id: load_visits
          type: Request
          params: get_visits
    blocks:
      - id: page_title
        type: Title
        properties:
          content: Lowdefy 运行验证
      - id: visits_table
        type: TableLight
        properties:
          data:
            _request: get_visits

cd /opt/lowdefy-demo
LOWDEFY_SECRET_MONGODB_URI="mongodb://127.0.0.1:27017" lowdefy dev --port 3000 --no-open

∙ Running 'lowdefy dev'. Lowdefy app version 7.1.0.
∙ Starting development server.
- Fetching @lowdefy/server-dev from npm.
∙ Fetched @lowdefy/server-dev from npm.
- Installing dependencies.
∙ Dependencies install successfully.
- Building config...
∙ /bin/sh: 1: git: not found
⚠ No menus found. Building default menu.
✔ Built config in 606ms.
  VITE v8.0.16  ready in 347 ms
  ➜  Local:   http://127.0.0.1:3001/

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:3000/
netstat -ltn | grep 3000

200
tcp6       0      0 ::1:3000                :::*                    LISTEN

cd /opt/lowdefy-demo
lowdefy build

∙ Running 'lowdefy build'. Lowdefy app version 7.1.0.
∙ Starting build.
- Fetching @lowdefy/server from npm.
∙ Fetched @lowdefy/server from npm.
- Installing dependencies.
∙ Dependencies install successfully.
- Running Lowdefy build.
∙ $ node lowdefy/build.mjs
∙ /bin/sh: 1: git: not found
⚠ No menus found. Building default menu.
∙ Lowdefy build successful.
- Installing dependencies.
∙ Dependencies install successfully.
- Running client build.
∙ Client bundle size (gzip): 328.88 kB.
∙ Client build successful.
✔ Build successful.

ls .lowdefy/server

lowdefy
lowdefy-build
node_modules
package.json
package.original.json
pnpm-lock.yaml
pnpm-workspace.yaml
postcss.config.cjs
public
public_default
src
vite.config.js

[Unit]
Description=Lowdefy application server
Documentation=https://docs.lowdefy.com
After=network.target mongod.service

[Service]
Type=simple
User=lowdefy
Group=lowdefy
WorkingDirectory=/opt/lowdefy-demo
Environment=LOWDEFY_SECRET_MONGODB_URI=mongodb://127.0.0.1:27017
ExecStart=/usr/bin/lowdefy start --port 3000
Restart=on-failure
RestartSec=5
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

sudo useradd --system --home /opt/lowdefy-demo --shell /usr/sbin/nologin lowdefy
sudo chown -R lowdefy:lowdefy /opt/lowdefy-demo
sudo systemctl daemon-reload
sudo systemctl enable lowdefy
sudo systemctl start lowdefy
systemctl is-active lowdefy

Created symlink /etc/systemd/system/multi-user.target.wants/lowdefy.service → /etc/systemd/system/lowdefy.service.
active

systemctl status lowdefy --no-pager -l | head -18
journalctl -u lowdefy -n 12 --no-pager

● lowdefy.service - Lowdefy application server
     Loaded: loaded (/etc/systemd/system/lowdefy.service; enabled; vendor preset: enabled)
     Active: active (running) since Tue 2026-10-27 17:04:25 UTC; 4s ago
       Docs: https://docs.lowdefy.com
   Main PID: 4926 (MainThread)
      Tasks: 23 (limit: 2932)
     Memory: 136.5M
        CPU: 990ms

17:04:34 ∙ Running 'lowdefy start'. Lowdefy app version 7.1.0.
17:04:34 ✔ Started server.
17:04:35 ∙ Lowdefy server listening on http://localhost:3000
17:04:35 ∙   app_name: Lowdefy Demo
17:04:35 ∙   app_version: 0.1.0
17:04:35 ∙   server: lowdefy
17:04:35 ∙   port: 3000
17:04:35 ∙   lowdefy_version: 7.1.0

curl -s -o /dev/null -w "HTTP %{http_code}\n" http://localhost:3000/

HTTP 200

curl -s -X POST http://localhost:3000/api/request/home/insert_visit \
  -H "Content-Type: application/json" -d "{}"
curl -s -X POST http://localhost:3000/api/request/home/get_visits \
  -H "Content-Type: application/json" -d "{}"

{"id":"request:home:insert_visit","success":true,"type":"MongoDBInsertOne","response":{"acknowledged":true,"insertedId":{"_oid":"6ae0d9a43426ba9e5e712bf5"}}}
{"id":"request:home:get_visits","success":true,"type":"MongoDBFind","response":[]}

mongosh --quiet lowdefy_demo --eval "db.visits.countDocuments()"
mongosh --quiet lowdefy_demo --eval "db.visits.find().toArray()"

2
[
  {
    _id: ObjectId('6ae0d9631b277c4a0b6c3cbc'),
    created_at: ISODate('2026-10-27T17:03:31.035Z')
  },
  {
    _id: ObjectId('6ae0d9a43426ba9e5e712bf5'),
    created_at: ISODate('2026-10-27T17:04:36.044Z')
  }
]

EnvironmentFile=/etc/lowdefy/lowdefy.env

# /etc/lowdefy/lowdefy.env
LOWDEFY_SECRET_MONGODB_URI=mongodb://127.0.0.1:27017

✖
-------------------------------------------------------------
  The package manager "pnpm" is required to run Lowdefy.
  Install pnpm as describe here:
  https://pnpm.io/installation
  or run  'corepack enable'.
-------------------------------------------------------------
✖ [Error] The package manager "pnpm" is required to run Lowdefy.

Error: [Server Error] Port 3007 is already in use.
To use a different port, either:
  - Run with the --port flag: pnpx lowdefy dev --port 3001
  - Set the port in your lowdefy.yaml:
    cli:
      port: 3001

# 停用并删除服务
sudo systemctl stop lowdefy
sudo systemctl disable lowdefy
sudo rm -f /etc/systemd/system/lowdefy.service
sudo systemctl daemon-reload

# 删除应用目录与用户
sudo rm -rf /opt/lowdefy-demo
sudo userdel lowdefy

# 卸载 CLI（方案 A）
sudo npm uninstall -g lowdefy

# 卸载 CLI（方案 B）
pnpm remove -g lowdefy

# 卸载 MongoDB（保留数据目录时跳过 rm）
sudo systemctl stop mongod
sudo apt-get purge -y mongodb-org mongodb-org-server mongodb-org-mongos mongodb-org-shell mongodb-org-tools
sudo rm -rf /var/lib/mongodb /var/log/mongodb

# 移除软件源
sudo rm -f /etc/apt/sources.list.d/mongodb-org-7.0.list
sudo rm -f /usr/share/keyrings/mongodb-server-7.0.gpg