syncthing --version

syncthing v2.1.7 "Hafnium Hornet" (go1.27.3 linux-amd64) debian@github.syncthing.net 2026-10-20 19:54:38 UTC [noupgrade]

systemctl is-active syncthing@root && curl -s -H "X-API-Key: LbDgdphpYTUQiq4SHqzaMbmhR36WY9wL" http://127.0.0.1:8384/rest/system/ping

active
{
  "ping": "pong"
}

syncthing --help

Usage: syncthing <command> [flags]

Flags:
  -h, --help           Show context-sensitive help.
  -C, --config=PATH    Set configuration directory (config and keys)
                       ($STCONFDIR)
  -D, --data=PATH      Set data directory (database and logs) ($STDATADIR)
  -H, --home=PATH      Set configuration and data directory ($STHOMEDIR)
      --version        Show current version, then exit

Commands:
  serve                  Run Syncthing (default)
  cli                    Command line interface for Syncthing
  browser                Open GUI in browser, then exit
  decrypt                Decrypt or verify an encrypted folder
  device-id              Show device ID, then exit
  generate               Generate key and config, then exit
  paths                  Show configuration paths, then exit
  upgrade                Perform or check for upgrade, then exit
  version                Show current version, then exit
  debug                  Various debugging commands
  install-completions    Print commands to install shell completions

Run "syncthing <command> --help" for more information on a command.

syncthing serve --help

Usage: syncthing serve [flags]

Run Syncthing (default)

Flags:
  -h, --help                      Show context-sensitive help.
  -C, --config=PATH               Set configuration directory (config and keys)
                                  ($STCONFDIR)
  -D, --data=PATH                 Set data directory (database and logs)
                                  ($STDATADIR)
  -H, --home=PATH                 Set configuration and data directory
                                  ($STHOMEDIR)
      --version                   Show current version, then exit

      --allow-newer-config        Allow loading newer than current config
                                  version ($STALLOWNEWERCONFIG)
      --audit                     Write events to audit file ($STAUDIT)
      --auditfile=PATH            Specify audit file (use "-" for stdout,
                                  "--" for stderr) ($STAUDITFILE)
      --db-maintenance-interval=8h
                                  Database maintenance interval; set to
                                  zero to disable periodic maintenance
                                  ($STDBMAINTENANCEINTERVAL)
      --db-delete-retention-interval=10920h
                                  Database deleted item retention interval
                                  ($STDBDELETERETENTIONINTERVAL)
      --gui-address=URL           Override GUI address (e.g.
                                  "http://192.0.2.42:8443") ($STGUIADDRESS)
      --gui-apikey=API-KEY        Override GUI API key ($STGUIAPIKEY)
      --log-file=PATH             Log file name (see below) ($STLOGFILE)
      --log-level=INFO            Log level for all packages
                                  (DEBUG,INFO,WARN,ERROR) ($STLOGLEVEL)
      --log-max-old-files=N       Number of old files to keep (zero to keep only
                                  current) ($STLOGMAXOLDFILES)
      --log-max-size=BYTES        Maximum size of any file (zero to disable log
                                  rotation) ($STLOGMAXSIZE)
      --log-format-timestamp="2006-01-02 15:04:05"
                                  Format for timestamp, set to empty to disable
                                  timestamps ($STLOGFORMATTIMESTAMP)
      --[no-]log-format-level-string
                                  Whether to include level string in log line
                                  ($STLOGFORMATLEVELSTRING)
      --[no-]log-format-level-syslog
                                  Whether to include level as syslog prefix in
                                  log line ($STLOGFORMATLEVELSYSLOG)
      --no-browser                Do not start browser ($STNOBROWSER)
      --no-port-probing           Don't try to find free ports for GUI
                                  and listen addresses on first startup
                                  ($STNOPORTPROBING)
      --no-restart                Do not restart Syncthing when exiting
                                  due to API/GUI command, upgrade, or crash
                                  ($STNORESTART)
      --no-upgrade                Disable automatic upgrades ($STNOUPGRADE)
      --paused                    Start with all devices and folders paused
                                  ($STPAUSED)
      --unpaused                  Start with all devices and folders unpaused
                                  ($STUNPAUSED)
      --debug-gui-assets-dir=PATH
                                  Directory to load GUI assets from
                                  ($STGUIASSETS)
      --debug-perf-stats          Write running performance statistics to
                                  perf-$pid.csv (Unix only) ($STPERFSTATS)
      --debug-profile-block       Write block profiles to
                                  block-$pid-$timestamp.pprof every 20 seconds
                                  ($STBLOCKPROFILE)
      --debug-profile-cpu         Write a CPU profile to cpu-$pid.pprof on exit
                                  ($STCPUPROFILE)
      --debug-profile-heap        Write heap profiles to
                                  heap-$pid-$timestamp.pprof each time heap
                                  usage increases ($STHEAPPROFILE)
      --debug-profiler-listen=ADDR
                                  Network profiler listen address ($STPROFILER)
      --debug-reset-delta-idxs    Reset delta index IDs, forcing a full index
                                  exchange

Logging always happens to the command line (stdout) and optionally to the
file at the path specified by --log-file=path. In addition to an path, the special
values "default" and "-" may be used. The former logs to DATADIR/syncthing.log
(see --data), which is the default on Windows, and the latter only to stdout,
no file, which is the default anywhere else.

 api             - REST API
 beacon          - Multicast and broadcast discovery
 config          - Configuration loading and saving
 connections     - Connection handling
 db/sqlite       - SQLite database
 dialer          - Dialing connections
 discover        - Remote device discovery
 events          - Event generation and logging
 fs              - Filesystem access
 main            - Main package
 model           - The root hub
 nat             - NAT discovery and port mapping
 pmp             - NAT-PMP discovery and port mapping
 protocol        - The BEP protocol
 relay/client    - Relay client
 scanner         - File change detection and hashing
 stun            - STUN functionality
 syncthing       - Main run facility
 upgrade         - Binary upgrades
 upnp            - UPnP discovery and port mapping
 ur              - Usage reporting
 versioner       - File versioning
 watchaggregator - Filesystem event watcher

syncthing cli --help

Usage: syncthing cli <command> [flags]

Command line interface for Syncthing

Flags:
  -h, --help                  Show context-sensitive help.
  -C, --config=PATH           Set configuration directory (config and keys)
                              ($STCONFDIR)
  -D, --data=PATH             Set data directory (database and logs)
                              ($STDATADIR)
  -H, --home=PATH             Set configuration and data directory ($STHOMEDIR)
      --version               Show current version, then exit

      --gui-address=STRING    ($STGUIADDRESS)
      --gui-apikey=STRING     ($STGUIAPIKEY)

Commands:
  cli show          Show command group
  cli debug         Debug command group
  cli operations    Operation command group
  cli errors        Error command group
  cli config        Configuration modification command group
  cli -             Read commands from stdin

syncthing cli show --help

Commands:
  cli show version          Show syncthing client version
  cli show config-status    Show configuration status, whether or not a restart
                            is required for changes to take effect
  cli show system           Show system status
  cli show connections      Report about connections to other devices
  cli show discovery        Show the discovered addresses of remote devices
                            (from cache of the running syncthing instance)
  cli show usage            Show usage report
  cli show pending          Pending subcommand group

syncthing cli show version

{
  "arch": "amd64",
  "codename": "Hafnium Hornet",
  "date": "2026-10-20T19:54:38Z",
  "isRelease": true,
  "longVersion": "syncthing v2.1.7 \"Hafnium Hornet\" (go1.27.3 linux-amd64) debian@github.syncthing.net 2026-10-20 19:54:38 UTC [noupgrade]",
  "os": "linux",
  "version": "v2.1.7"
}

syncthing cli show system | python3 -m json.tool | head -30

{
    "alloc": 9371584,
    "connectionServiceStatus": {
        "dynamic+https://relays.syncthing.net/endpoint": {
            "error": null,
            "lanAddresses": [
                "relay://171.213.174.222:22067/?id=IPEQNKG-6SYSCPJ-A75IGZU-KD55ELF-COH4ODL-VBAOF7A-6KC3XKK-TEFXQAT"
            ]
        },
        "quic://0.0.0.0:22000": {
            "error": null,
            "lanAddresses": [
                "quic://0.0.0.0:22000",
                "quic://10.89.67.2:22000"
            ]
        }
    }
}

syncthing cli operations --help

Commands:
  cli operations restart     Restart syncthing
  cli operations shutdown    Shutdown syncthing
  cli operations upgrade     Upgrade syncthing (if a newer version is available)
  cli operations folder-override
                             Override changes on folder (remote for sendonly,
                             local for receiveonly). WARNING: Destructive -
                             deletes/changes your data
  cli operations default-ignores
                             Set the default ignores (config) from a file

syncthing cli operations restart

syncthing cli config --help

Commands:

  ACTIONS:
    dump-json  Dump item as json

  PROPERTIES:
    version
    folders
    devices
    gui
    ldap
    options
    ignored-devices
    defaults

syncthing cli config folders list

sync-demo

syncthing generate --help

Usage: syncthing generate [flags]

Generate key and config, then exit

Flags:
  -h, --help                   Show context-sensitive help.
  -C, --config=PATH            Set configuration directory (config and keys)
                               ($STCONFDIR)
  -D, --data=PATH              Set data directory (database and logs)
                               ($STDATADIR)
  -H, --home=PATH              Set configuration and data directory ($STHOMEDIR)
      --version                Show current version, then exit

      --gui-user=STRING        Specify new GUI authentication user name
      --gui-password=STRING    Specify new GUI authentication password (use - to
                               read from standard input)
      --no-port-probing        Don't try to find free ports for GUI and listen
                               addresses on first startup ($STNOPORTPROBING)

syncthing generate --gui-user=admin --gui-password=q1w2e3r4 --home /root/.local/state/syncthing

2026-10-21 18:17:13 WRN Key exists; will not overwrite (log.pkg=github)
2026-10-21 18:17:13 INF Calculated device ID (device=BITUNOQ-VKBHIFH-2UWCK4D-CCANXZC-GV6VG3E-6JDFMHV-7VZW57L-F3LTKQX log.pkg=github)
2026-10-21 18:17:13 INF Updated GUI authentication user (name=admin log.pkg=github)
2026-10-21 18:17:13 INF Updated GUI authentication password (log.pkg=github)

syncthing device-id

BITUNOQ-VKBHIFH-2UWCK4D-CCANXZC-GV6VG3E-6JDFMHV-7VZW57L-F3LTKQX

syncthing version

Syncthing Version:      v2.1.7 "Hafnium Hornet" (go1.27.3 linux-amd64) debian@github.syncthing.net 2026-10-20 19:54:38 UTC
OS/Arch:                linux-amd64
Labels:                 noupgrade

Usage: syncthing decrypt [--password=STRING] [--to=PATH] [--limit=SIZE] [--verify] FOLDER FILE

syncthing paths

Configuration file:
        /root/.local/state/syncthing/config.xml

Device private key & certificate files:
        /root/.local/state/syncthing/key.pem
        /root/.local/state/syncthing/cert.pem

GUI / API HTTPS private key & certificate files:
        /root/.local/state/syncthing/https-key.pem
        /root/.local/state/syncthing/https-cert.pem

Database location:
        /root/.local/state/syncthing/index-v2

Log file:
        /root/.local/state/syncthing/syncthing.log

GUI override directory:
        /root/.local/state/syncthing/gui

Default sync folder directory:
        /root/Sync

syncthing upgrade --help

Usage: syncthing upgrade [command [flags]]

Perform or check for upgrade, then exit

Commands:
  upgrade check    Check for an upgrade
  upgrade to       Upgrade to a specific version
  upgrade stable   Upgrade to the latest stable version

syncthing debug --help

Commands:
  debug reset-database         Reset the database, forcing a full rescan and
                               resync
  debug database-statistics    Display database size statistics
  debug database-counts        Display database folder counts
  debug database-file          Display database file metadata

strelaysrv --help

Usage of strelaysrv:
  -debug
        Enable debug output
  -ext-address string
        An optional address to advertise as being available on.
                Allows listening on an unprivileged port with port forwarding from e.g. 443, and be connected to on port 443.
  -global-rate int
        Global rate limit, in bytes/s
  -keys string
        Directory where cert.pem and key.pem is stored (default ".")
  -listen string
        Protocol listen address (default ":22067")

stdiscosrv --help

Usage: stdiscosrv [flags]

Flags:
  -h, --help                       Show context-sensitive help.
      --shutdown-delay=FLOAT-64    Time to wait before shutdown after
                                   receiving a shutdown signal (s)
                                   ($DISCOVERY_SHUTDOWN_DELAY)
  -d, --debug                      Print debug output ($DISCOVERY_DEBUG)
  -v, --version                    Print version and exit

curl -s -w '\n%{http_code}\n' http://127.0.0.1:8384/rest/system/version

Forbidden

403

CSRF Error

403

curl -s -H 'X-API-Key: LbDgdphpYTUQiq4SHqzaMbmhR36WY9wL' http://127.0.0.1:8384/rest/system/version

{
  "arch": "amd64",
  "codename": "Hafnium Hornet",
  "date": "2026-10-20T19:54:38Z",
  "isRelease": true,
  "longVersion": "syncthing v2.1.7 \"Hafnium Hornet\" (go1.27.3 linux-amd64) debian@github.syncthing.net 2026-10-20 19:54:38 UTC [noupgrade]",
  "os": "linux",
  "stamp": "1792526078",
  "tags": [
    "noupgrade"
  ],
  "version": "v2.1.7"
}

curl -s -H "X-API-Key: LbDgdphpYTUQiq4SHqzaMbmhR36WY9wL" http://127.0.0.1:8384/rest/system/status | python3 -c "import json,sys; d=json.load(sys.stdin); print(json.dumps({k:d[k] for k in ['myID','startTime','uptime','alloc','goroutines','tilde','discoveryEnabled']}, indent=2))"

{
  "myID": "BITUNOQ-VKBHIFH-2UWCK4D-CCANXZC-GV6VG3E-6JDFMHV-7VZW57L-F3LTKQX",
  "startTime": "2026-10-21T18:17:13Z",
  "uptime": 346,
  "alloc": 9533064,
  "goroutines": 101,
  "tilde": "/root",
  "discoveryEnabled": true
}

curl -s -H "X-API-Key: LbDgdphpYTUQiq4SHqzaMbmhR36WY9wL" http://127.0.0.1:8384/rest/stats/device | python3 -m json.tool

{
    "BITUNOQ-VKBHIFH-2UWCK4D-CCANXZC-GV6VG3E-6JDFMHV-7VZW57L-F3LTKQX": {
        "lastSeen": "1970-01-01T00:00:00Z",
        "lastConnectionDurationS": 0
    },
    "H4EJJ6T-TDBKQFV-AK4FR2S-XCOS326-X3A4NQY-D4HJ7JS-BKYLK3X-IWB6HQB": {
        "lastSeen": "2026-10-21T18:22:59Z",
        "lastConnectionDurationS": 1.9239573079999999
    }
}

curl -s -H "X-API-Key: LbDgdphpYTUQiq4SHqzaMbmhR36WY9wL" http://127.0.0.1:8384/rest/system/error

{
  "errors": null
}

curl -s -H "X-API-Key: LbDgdphpYTUQiq4SHqzaMbmhR36WY9wL" "http://127.0.0.1:8384/rest/db/status?folder=sync-demo" | python3 -m json.tool | head -24

{
    "errors": 0,
    "pullErrors": 0,
    "globalFiles": 2,
    "globalBytes": 3145774,
    "localFiles": 2,
    "localBytes": 3145774,
    "needFiles": 0,
    "needBytes": 0,
    "inSyncFiles": 2,
    "inSyncBytes": 3145774
}

curl -s -X POST -H "X-API-Key: LbDgdphpYTUQiq4SHqzaMbmhR36WY9wL" "http://127.0.0.1:8384/rest/db/scan?folder=sync-demo" -w " [%{http_code}]"

 [200]

curl -s -H "X-API-Key: LbDgdphpYTUQiq4SHqzaMbmhR36WY9wL" "http://127.0.0.1:8384/rest/db/file?folder=sync-demo&file=hello.txt" | python3 -c "import json,sys; d=json.load(sys.stdin); print(json.dumps(d.get('global'), indent=2))"

{
  "blocksHash": "o0ZK524L26PDP14Lp5O5td6MUlwPzoWg9GUDKwuN/do=",
  "deleted": false,
  "ignored": false,
  "modified": "2026-10-21T18:20:52.194515727Z",
  "modifiedBy": "BITUNOQ",
  "name": "hello.txt",
  "numBlocks": 1,
  "permissions": "0644"
}

curl -s -H "X-API-Key: LbDgdphpYTUQiq4SHqzaMbmhR36WY9wL" "http://127.0.0.1:8384/rest/events?limit=3" | python3 -c "import json,sys; d=json.load(sys.stdin); print([(e['id'], e['type']) for e in d])"

[(63, 'StateChanged'), (64, 'StateChanged'), (65, 'StateChanged')]