Deploy a Node.js app from Nigeria

OneBit Deploy is a Platform-as-a-Service built for Nigerian developers. You push to GitHub and OneBit builds and runs your app — billing is in naira via Paystack, so there is no dollar card requirement and no exchange-rate markup.

This tutorial walks you through deploying a Node.js app from scratch in under five minutes.

Prerequisites

• A GitHub account with your Node.js repository already pushed to it.
• A free account at deploy.onebit.ng.

Your repository must include a package.json with a start script, for example:

{
  "scripts": {
    "start": "node index.js"
  }
}

OneBit auto-detects Node.js projects, so no platform-specific config file is required.

Step 1 — Sign up and open your apps

Create a free account at deploy.onebit.ng. You will land on Apps, where all your apps live.

Step 2 — Add an app

On Apps, press Add app. There is no type to choose: the console works out that your project is a Node.js app — Express, Fastify, Koa, or a plain HTTP server.

Step 3 — Connect your GitHub repository

Open the GitHub account tab and press Connect GitHub. OneBit installs a lightweight GitHub app that lets it read your repositories and listen for pushes.

Pick the repository, choose the Branch (usually main or master) and press Import.

Step 4 — Configure the build

OneBit auto-detects Node.js ("A Node.js app.") and fills in sensible defaults:

• Build command — npm install (or npm ci)
• Start command — pulled from the start script in your package.json

To change them before the first deploy, open Build settings. Add any environment variables your app needs — API keys, database URLs, port numbers — on the app's Environment tab once it exists; saving one restarts the app so it picks the value up.

Step 5 — Pick a plan and put it online

Choose the plan that fits your project (you can move between plans any time on Plan & billing):

Prices exclude 7.5% VAT, added at checkout.

Check the Name and press Deploy. OneBit builds a container image from your source, then starts it on a public HTTPS URL.

Watch the build output in the app's Logs tab under Build — when it is done the app shows Live and its live URL.

Step 6 — Your app is live

Once the build finishes, your Node.js app is running on a public URL with automatic HTTPS. Every subsequent push to the connected branch triggers a new deploy automatically — no manual steps required.

Why Nigerian developers choose OneBit Deploy

Pay in naira, no dollar card needed. Billing runs through Paystack in NGN. There is no FX fee, no exchange-rate guessing, and no surprise charges in dollars at the end of the month. This alone makes OneBit a practical Heroku alternative for developers in Nigeria.

Zero config for Node.js. OneBit detects your stack and sets up the build automatically. Push your code and it deploys.

Automatic HTTPS. Every app gets a free SSL certificate — no manual certificate management.

Git-driven deploys. Every push to your connected branch triggers a fresh build and deploy. No separate CI setup required.

Live logs and metrics. See what your app is doing in real time in the console: its Logs tab, and Status on its Overview. Dig deeper in Logs & metrics.

Next steps