How can I set up and schedule Bulk top-ups on my server using Github

Developers · Bulk Top-up

Deploy your own bulk top-up server in one command

A practical walkthrough of Reloadly's open-source bulk airtime processing app on GitHub — what it is, what you need, and how to get it running.

In this article

1. What this app actually does
2. Prerequisites
3. Clone and install
4. Log in with the default credentials
5. Day-to-day commands
6. Under the hood, for advanced users
7. Frequently asked questions

The project lives at github.com/Reloadly/sample-bulk. It's a self-hosted web application — built on PHP Laravel with a Vue.js front end — that wraps Reloadly's Airtime API so you can process bulk top-ups by uploading a CSV file, instead of calling the API endpoint for every single transaction.

It's maintained directly by Reloadly and designed to be deployed with little to no programming knowledge — the whole setup is wrapped in a single install command.

Everything runs inside Docker, so the entire environment is reproducible and isolated from whatever else is on your machine. Before you start, make sure your server or machine has:

Once Docker and Make are installed, this single command clones the repository and kicks off the full installation process:

That one line clones the whole project into a sample-bulk folder and runs the installer automatically. Once it finishes, the app runs on your localhost (port 80 by default) or on whatever IP your server holds.

Open the project's URL (localhost or your server's IP/domain) in a browser and log in with the system admin account that ships with the project:

All of these run from inside the sample-bulk folder:

⚙️ Under the hood, for advanced users

The installer creates and runs two Docker containers:

• Database container — runs MariaDB. No port is exposed by default for security, though it does provide an internal port (3306) you can open by editing docker-compose.yml if you need outside access.
• Web server container — Apache on PHP 7.3, with the full build configuration in DockerFiles/Dockerfile. By default it opens port 80 on the host machine; change this in docker-compose.yml if you need a different port.

If you change the default database or admin credentials in docker-compose.yml and .env, you'll need to delete the volumes directory (if it was already created) and run make install again so the system reinstalls using the new credentials.

❓ Frequently asked questions