Deploy
Requirements
Server, domain and phone you need.
LokiPay is self-hosted: one installation per business. We deploy and maintain it for you, on infrastructure you own. This is what an installation needs.
Server#
| Minimum | Recommended | |
|---|---|---|
| CPU / RAM | 1 vCPU, 1 GB | 2 vCPU, 2 GB |
| Disk | 10 GB | 20 GB SSD (database, backups, app releases) |
| OS | Any Linux with Docker 24+ and Docker Compose v2 | Ubuntu 22.04 / 24.04 LTS |
| Network | Ports 80 and 443 open | Static IP |
deploy.sh installs and configures nginx and certbot on the host. LokiPay can share a server with other apps — it only binds to loopback ports (5310 for the API and 5534 for Postgres by default, both configurable).
Domain#
A subdomain such as pay.yourshop.com with a DNS A record pointing at the server. Customers see this domain on payment links and checkout pages, and the relay phone connects to it.
Relay phone#
- An Android phone (Android 8 or newer) with the SIM that receives your MoMo payments.
- Mobile data or Wi-Fi, ideally always on charge.
- One phone per MoMo SIM. You can pair several phones if you receive on several SIMs.
Use a dedicated phone
The relay app reads incoming SMS from your MoMo senders. A phone kept at the shop or office, on charge, gives the most reliable verification.