How to install
Documentation · Own Ebook self-hosted
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
- Your domain, without
https://or a path. - Your website or brand name.
- Your administrator email.
- A new administrator password with at least 12 characters.
- 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.
All topics
- العربية: تثبيت الاستضافة المشتركة بالصور
- Start here: 6 simple steps
- Will my hosting work?
- System requirements
- How to install
- Database setup
- License activation
- Production and development installations
- Moving to a new domain
- Reissue
- Updating Own Ebook
- Backup and rollback
- Common installer errors
- Common license errors
- Support