Own Ebook Customer Portal

Backup and rollback

Documentation · Own Ebook self-hosted

Keep independent off-server backups of the MongoDB database and the entire persistent data directory. Environment files and the private licensing identity are required to restore the same installation.

Update attempts save a lossless Extended JSON database snapshot, collection options and indexes, plus a persistent-files archive. The update tool rolls code back if health checks fail; accepted version-1 updates do not run schema migrations.

To recover a database snapshot, create a new empty database and a protected mode-600 environment file containing its MONGODB_URI. Run node management/restore-database.cjs BACKUP_DIRECTORY TARGET_ENV_FILE. The restore verifies file hashes and refuses a database that already contains collections. Point the stopped application at the restored database, then start it and verify its health.