Own Ebook Customer Portal

Start here: 6 simple steps

Documentation · Own Ebook self-hosted

Install on a prepared Hostbas Hero account with external MongoDB Atlas. Choose your domain and your own administrator login.

Check this before buying hosting: choose either a provider-prepared shared account with Atlas or a compatible managed Linux server. For shared hosting, follow the Arabic guide with screenshots. Use version 1.0.16 or newer, which includes the English browser installer and a prepared frontend. Uploading the ZIP to a PHP/MySQL hosting account will not install it. Check your hosting →
Already given an installer link and Setup key by your provider? Open that link and start with the browser installer. Do not upload the package again or create another Node.js application. Prepare your own empty Atlas database and database-scoped user for the installer.
  1. Choose where it will run

    Use a separate prepared Hero account for Own Ebook. If you already have a website on shared hosting, keep it there. You can use a subdomain such as books.yourdomain.com for Own Ebook.

    No server experience? Ask Hostbas to confirm Node.js, Terminal, Application Manager, Chromium libraries, accessible Arabic/English font files and outbound Atlas access for your account. Agree on their service and any fees first. Copy the hosting checklist.

  2. Download your software from Gumroad

    After payment, open the product content from your Gumroad receipt or Library. Download ownebook-1.0.16-stable-full.zip or the newer full package shown there. The application ZIP is attached directly to your purchase.

    You can also use your purchaser account for eligible downloads. Creating that separate account is not required to install the Gumroad ZIP. Do not use an update ZIP for a new installation.

  3. Copy your Gumroad license key

    Copy the personal key shown on your Gumroad content page or receipt. Paste it into the installer when asked for the activation code. Keep it private; it is separate from your passwords. These documentation pages are public and require no sign-in.

  4. Upload and open the browser installer

    Follow the Arabic guide with screenshots. Upload and extract the full ZIP in /home/YOUR_USER/, leaving ownebook/start.cjs inside it. Never put application files inside public_html, an add-on domain’s DocumentRoot, or any directory served by the web server. For the self-managed setup path, create the Node.js application with ownebook and start.cjs, enable HTTPS and open your domain.

    Unlock setup with the private key shown in File Manager. Check Node.js, enter the Atlas template/password/database, choose your site name and administrator credentials, then paste your Gumroad key. After completion, Stop/Start that application in the panel, as the browser installer requests. If your provider explicitly confirms automatic restart, wait for readiness and open /login instead. The guide’s screenshots show Webuzo, even where Hostbas labels the entry button “Login to cPanel”; other providers’ menus differ.

  5. Open your own website

    After automatic setup reports Ready and HTTPS is working, open https://books.yourdomain.com/login, replacing the example with your domain. Sign in using the administrator details you chose during installation.

    After you sign in, open Admin. Your purchaser account at account.ownebook.com and your installed website have separate logins.

  6. Set up your business and check it

    Open Admin → AI Costs & Billing → OpenRouter connection. Get a key from your OpenRouter account, paste it and click Verify & save. Use Test connection to check it later. This is available from version 1.0.13 and needs no server-file editing or restart. See the illustrated steps. Add your branding, email and payment-provider settings. Check your license, send a test email, create a small test ebook and open its PDF to verify readable Arabic and English text. A successful file download alone is insufficient. AI usage and provider charges belong to your accounts. Configure your legal pages and backups before enabling public signup.

For future updates: open Admin → License & Updates. Fresh 1.0.14+ installations include the controller. Review the release summary and click Update now. Older installations require one manual transition and controller restart. Follow the instructions for your hosting type.