Skip to main content

Command-line tools

Packaged binaries are shown below. From a source checkout, run the server with ./scripts/run.sh -- ARGS and portability with ./scripts/run.sh --bin jiandu-portability -- ARGS.

Server​

jiandu [--config FILE] [--data-dir DIR]
        [--database-backend BACKEND] [--database-url-file FILE]
        [--bind IP:PORT] [--ingress-mode MODE]
        [--public-origin ORIGIN]
        [--ingress-trusted-proxy-cidrs CIDRS]
        [--check-config]

Use --check-config to validate without starting. Unknown options and missing values fail rather than being ignored.

Recovery and portable export​

jiandu-portability backup DESTINATION [CONFIG OPTIONS]
jiandu-portability verify-backup SOURCE
jiandu-portability restore SOURCE DESTINATION [CONFIG OPTIONS]
jiandu-portability export DESTINATION [CONFIG OPTIONS]
jiandu-portability verify-export SOURCE

Accepted configuration options are --config, --data-dir, --database-backend, and --database-url-file where applicable. Destinations must be explicit and new.

Example:

jiandu-portability backup /backups/jiandu-2026-08-26 \
  --data-dir /srv/jiandu-data
jiandu-portability verify-backup /backups/jiandu-2026-08-26

See Backup and restore before using restore.

Linux/SANE capture agent​

jiandu-capture-agent enroll --server https://host --code CODE --state PATH
jiandu-capture-agent run --state PATH

Generate the one-use enrollment code in Jiandu Settings. Keep PATH private and persistent. If it is lost or invalid, revoke the enrollment and enroll again.