Own Ebook Customer Portal

Common installer errors

Documentation · Own Ebook self-hosted

Hostbas Hero + MongoDB Atlas (use 1.0.14+): use the illustrated Arabic shared-hosting guide. It uses the separate English browser installer and prepared frontend. The server instructions below apply to the VPS/systemd option only.

Shared hosting and browser installer

No Application Manager or supported Node.js: the provider must prepare runtime support first. If they already supplied your installer URL and Setup key, use those instead of creating another application.

Wrong upload location: keep /home/YOUR_USER/ownebook/start.cjs private. public_html, add-on domain DocumentRoots and other web-served folders are not application locations.

PermissionError from os.getcwd() after CageFS entry: the inherited working directory may be inaccessible. On the documented Hostbas setup, use the corrected generator: it runs cd inside lve_wrapper before Node. Other providers must confirm their Node path and isolation mechanism.

Atlas timeout: confirm database-scoped readWrite credentials, the application’s actual public egress IP in Atlas, host-side outbound port 27017 to Atlas nodes, and DNS/SRV. Shared IP/domain IP may be different. Add Current IP Address is optional for local Compass access; keep the host’s egress entry. Never disable TLS verification.

PDF fails or shows squares: check Chromium libraries and actual font files visible inside CageFS. fc-list may show cached names whose files are inaccessible. In the myaton case, account-local DejaVu fonts with their license resolved missing glyphs. Open a PDF and verify readable Arabic and English; file existence/size is not a passing visual check. Do not automatically raise account limits or change the plan.

Installer says ready: 1.0.14 still requests Stop/Start in the general Application Manager path. If the provider confirms automatic restart, wait for readiness and open /login. Never restart an unrelated application or create a duplicate.

LiteSpeed 421/426: ask the provider to review original Host forwarding, a single X-Forwarded-Proto=https, canonical-domain redirects and the /.well-known/ certificate-renewal exception. Provider-only diagnostic appendix.

Interrupted installation: retain files, database contents and logs for review. Do not delete an existing database or overwrite it to restart. Check requirements alone does not prove Atlas connectivity, activation or administrator creation.

VPS/systemd installer only

Automatic setup says the server is not empty: use a new separate server. Do not uninstall another site's web server or bypass this check.

Automatic setup stopped at HTTPS: confirm that the chosen hostname points to this server, remove an incorrect AAAA record, and allow inbound ports 80 and 443. If the application stage completed, run sudo bash setup/easy-install.sh --resume from the same package. Earlier interrupted stages require technician review; saved application files and databases are preserved.

Check before installing: sudo bash setup/easy-install.sh --check reads the server requirements without changing files or services. It is not a substitute for the domain/HTTPS validation.

Existing directory or database: the installer intentionally refuses to overwrite an installation or user database. Use new paths and a dedicated empty database.

Node version: use a supported LTS version, minimum Node 22.

Database connection or transactions: confirm the URI, database-scoped credentials, network allowlist and replica-set configuration.

License refused: verify your credential, production/development slot and licensed host. Contact support if a lost installation occupies your slot.

Build failure: check available memory and disk space, dependency download access and the installation logs. Do not delete existing customer data to retry setup.