Free and Open Source Monero Point of Sale (POS)
Monero Merchant is a FOSS Android point-of-sale (POS) system for accepting Monero (XMR) payments. It provides a self-hosted, trustless, and secure payment solution for vendors and merchants.
- Open Source: Licensed under GNU GPL v3.0.
- Trustless Architecture: Operate your own backend; no reliance on third parties.
- Device-Agnostic: Works on any Android device — no proprietary hardware.
- Receipt Printing: Supports Bluetooth ESC/POS printers.
- Scalable: Unlimited POS clients and vendors, centrally managed.
- Secure: No wallet keys stored or exposed on client devices.
- Integrated Backend: Backend API interfaces with
monerodand MoneroPay. - Fast Payments: Supports 0-confirmation Monero transactions in 5–10 seconds.
- Client: Any Android device, with or without a Bluetooth mobile printer.
- Backend: Ubuntu LTS VPS or LAN environment (low-spec compatible).
-
Enter the amount in your
primaryFiatCurrencyand tap the green button. -
The app generates a Monero payment QR or NFC tag with address, amount, and note prefilled. The customer scans it and sends funds using any Monero wallet.
-
Once the payment reaches the configured confirmation threshold (0, 1, or 10), the app automatically advances to the receipt screen where you can:
- Print a receipt
- Start a new order
- Upload a logo (appears on receipts)
- Edit company name and contact details
- Customize footer text
- Configure the
primaryFiatCurrency - Add multiple
referenceFiatCurrencies
- Enable PIN protection for app startup or settings access
- Note: PINs cannot currently be reset — choose carefully
- Select connection type (Bluetooth tested and supported)
- Adjust printer parameters if needed
- Use Test Print to verify output
git clone https://github.com/Monero-Merchant/monero-merchant- Launch Android Studio
- Select Open an Existing Project
- Navigate to
monero-merchant/posand open it
Android Studio auto-installs dependencies. If not, manually sync Gradle:
File > Sync Project with Gradle Files
View > Tool Windows > Build Variants
Select debug or release.
Build > Build APK(s)
./gradlew assembleDebug # Debug build
./gradlew assembleRelease # Release build (unsigned)Output: app/build/outputs/apk/
- Docker Engine ≥ 24
- Docker Compose plugin
- 8 GB RAM, ~10 GB free disk space
- User added to
dockergroup
git clone https://github.com/Monero-Merchant/monero-merchant
cd monero-merchant/pos
docker compose build --no-cache
docker compose up --abort-on-container-exitOutput APK: app/build/outputs/apk/debug/app-debug.apk
- Docker (user added to docker group)
- Docker Compose
- Git
- OpenSSL
git clone https://github.com/Monero-Merchant/monero-merchant
cd monero-merchant
make install
To update an existing install, run git pull and then make install again. It keeps your .env and only fills in values that are missing.
The vendor portal is at http://<server>:8080/, the admin dashboard at /admin/ (log in with ADMIN_NAME and ADMIN_PASSWORD from .env), and POS devices connect to http://<server>:8080. For HTTPS, point a domain at the server, set SITE_ADDRESS=<domain>, HTTP_PORT=80 and HTTPS_PORT=443 in .env, and run make restart.
The gateway service is Caddy with gateway/Caddyfile. To use your own proxy instead, remove it and route:
/apiand/api/*tobackend:8080, with WebSocket upgrades allowed- everything else to
frontend:8080
The proxy must overwrite X-Real-IP with the client address, and the backend must only be reachable through it. Otherwise clients can fake their IP and get around the rate limits.
MoneroPay creates the server wallet in moneropay/data/wallet/ on first start. It has no password, so keep that folder private, and back up the seed under Settings in the admin dashboard.
To restore the same wallet from its seed:
docker compose stop moneropay monero-wallet-rpc
sudo mv moneropay/data/wallet moneropay/data/wallet.old
docker compose up -d monero-wallet-rpc
Then use "Restore from Seed" on the dashboard's home page, and run docker compose up -d. Restoring a different wallet this way breaks pending sales, because MoneroPay's database still refers to the old one.
make up # start services
make restart # restart containers (after .env changes)
make build # build the backend, frontend and gateway images from local source
make rebuild # build local source and recreate the backend, frontend and gateway
make down # stop containers
make ps # show running containers
make logs # stream logs
make clean # remove containers and build cache; preserve database and wallet data
make reset # WARNING: delete containers, database/wallet data, .env, and local dependencies
For detailed backend API usage, see
backend/README.md.
Support the project with Monero (XMR):
88zkpYQRJPmeuycSN7Jx3UHq9vH1u2dD8eE1rECvCAouPj75Cdnu1eUacQ5p7ZMvdr4e6BRe2FShv4HoatSs9HcwEeZCupZ
Licensed under the GNU General Public License v3.0. See LICENSE for details.