DBX for fnOS
This directory packages the existing DBX Web container as a native fnOS application package. The FPK contains the application metadata and Docker Compose integration; the DBX image is pulled from the CNB registry when the application is installed.
Build
Run from the repository root:
./deploy/fnos/build.sh
The script reads the version from crates/dbx-web/Cargo.toml, downloads and
verifies the official fnpack binary when one is not already available, and
writes these artifacts to dist/fnos/:
DBX_<version>_fnos.fpkDBX_<version>_fnos.fpk.sha256
Optional overrides:
DBX_FNOS_VERSION=0.6.25 \
DBX_FNOS_IMAGE=docker.cnb.cool/dbxio.com/dbx:0.6.25 \
DBX_FNOS_CHANGELOG='升级至 DBX 0.6.25。' \
FNPACK_BIN=/path/to/fnpack \
./deploy/fnos/build.sh
Release builds must use an immutable version tag. The build rejects latest
and verifies that the package version matches the image tag by default.
Runtime layout
- Host port:
4224 - Container port:
4224 - Persistent application data:
${TRIM_PKGVAR}->/app/data - Persistent backups:
${TRIM_PKGVAR}/backups->/app/backups - Container name:
dbx-fnos - Desktop entry: opens DBX in a browser tab
DBX password protection remains enabled. Users set the initial password from
the DBX Web interface; the package never enables DBX_DISABLE_PASSWORD.
The draft application-center copy, support details, and privacy disclosure are
maintained in store-listing.zh-CN.md.
Device validation still required
Before submitting a release to the fnOS application center, validate on a clean fnOS device:
- Install the generated FPK.
- Confirm the versioned CNB image is pulled for the device architecture.
- Open DBX from the desktop and set the initial password.
- Create and reconnect to a database connection.
- Restart DBX and confirm connections persist.
- Upgrade from the previous FPK and confirm data remains intact.
- Stop and start the application from the application center.
- Uninstall and confirm the displayed data-removal behavior matches fnOS.