Own Ebook Customer Portal

How to install

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.

Provider already supplied a browser-installer URL and Setup key? Open that link and complete setup there. Do not upload again or create another Node.js application. The following steps are for a new VPS, not that prepared shared account.

The alternative VPS path is automatic setup on a new Ubuntu 24.04 server. Your managed hosting provider can perform the server step for you. Hosting and installation services are separate from buying the script.

Download the one-page installation checklist (PDF).

1. Ask for the right server

Use a new Ubuntu 24.04 x86-64 VPS with AVX, root/sudo and systemd, at least 4 GB RAM and 20 GB free disk. The automatic installer refuses servers containing existing web-server or hosting-panel configurations. This root installer does not run on shared accounts; Hero uses the separate guide linked above. Copy the provider checklist.

2. Point your domain to it

Point the A record for your chosen hostname, such as books.yourdomain.com, to the new server. Keep your main website and email records unchanged. Allow inbound ports 80 and 443. Remove an old AAAA record for this hostname unless IPv6 is separately configured.

3. Upload the full package

Download the full installation ZIP directly from your Gumroad purchase content. Your optional purchaser account also provides eligible downloads. Upload the ZIP by SFTP to a private directory outside the web folder, then extract it. The application is inside the ownebook directory. Do not use an update ZIP for a new installation.

4. Run one command and enter five details

In an SSH session, enter the extracted ownebook directory and run:

sudo bash setup/easy-install.sh
  1. Your domain, without https:// or a path.
  2. Your website or brand name.
  3. Your administrator email.
  4. A new administrator password with at least 12 characters.
  5. Your Own Ebook activation code or native Gumroad license key, copied exactly.

Review the certificate terms and type INSTALL. Keep the session open. Automatic setup prepares Node.js, your private MongoDB database, the PDF browser, the application and HTTPS. You do not enter a database connection string.

5. Sign in and configure your business

Wait for Ready: https://YOUR-DOMAIN/login, then sign in using the administrator credentials you chose. Configure your own AI, email and payment providers, branding, legal pages and backups. Create a test book and export a PDF before opening public signup.

If setup stops

Read-only server checks are available with sudo bash setup/easy-install.sh --check. If only HTTPS issuance failed after the application was installed, correct the domain/firewall settings and run sudo bash setup/easy-install.sh --resume from the same package. If application or database setup was interrupted, ask your technician to inspect the saved state. Do not delete data to retry. Recovery information is private under /var/lib/own-ebook-setup.

Technician option: already-prepared infrastructure

The original sudo bash setup/install.sh is still available. It needs preinstalled Node.js/npm, Python 3, Nginx/systemd and an empty MongoDB replica-set or Atlas database. It asks for the database URI as well as the site and administrator details. This manual path configures HTTP; your technician must enable HTTPS. It does not prepare the database automatically.

Backups: /var/lib/own-ebook contains private settings and generated files, while automatic setup stores MongoDB data in /var/lib/own-ebook-mongodb. Keep proper database backups and off-server copies. Signed application updates use the existing updater.