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 monerod and 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).

1. Enter the amount in your primaryFiatCurrency and tap the green button.

2. 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.

3. 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

• Android Studio

git clone https://github.com/Monero-Merchant/monero-merchant

1. Launch Android Studio
2. Select Open an Existing Project
3. Navigate to monero-merchant/pos and 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

Output: app/build/outputs/apk/

• Docker Engine ≥ 24
• Docker Compose plugin
• 8 GB RAM, ~10 GB free disk space
• User added to docker group

git clone https://github.com/Monero-Merchant/monero-merchant
cd monero-merchant/pos
docker compose build --no-cache
docker compose up --abort-on-container-exit

git clone https://github.com/Monero-Merchant/monero-merchant
cd monero-merchant/pos
docker run --rm \
  -v "$PWD":/workspace \
  -v monero-merchant-gradle:/home/gradle-cache \
  -v monero-merchant-android-sdk:/opt/android-sdk \
  ghcr.io/ajs-xmr/xmrpos-android-builder:df7af4d

Output APK: app/build/outputs/apk/debug/app-debug.apk

• Clean Ubuntu LTS VPS
• Docker (user added to docker group)
• Docker Compose
• Git
• OpenSSL

git clone https://github.com/Monero-Merchant/monero-merchant

cd monero-merchant

make install

make up # start services

make restart # restart containers (after .env changes)

make rebuild # rebuild images and restart

make down # stop containers

make ps # show running containers

make logs # stream logs

make clean # remove containers, volumes, and build cache

make reset # full reset: clean + delete .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.