All providers

Monero

Learn how to self-host Monero. Run the wallet, accept Monero payments, no middle man... not even us. This guide takes the easy road, with the Monero app and a ready-made server.

What you need

FieldWhat it does
Your Monero server addressYour server's public address-minting route. We call it to get a fresh address for each order. Not secret.
Shared secretA shared secret your server signs with and we verify. It can never touch your wallet. Secret.

Self-hosting means running the blockchain yourself. You run the Monero wallet app, a wallet helper, a ready-made server, and a public address tool on your computer. This guide walks through it on a Mac.

Money flow

Money

  1. Buyer

    Taps your Coin Moebius Buy Button and pays from their own wallet.

  2. Your product page

    Your Coin Moebius Buy Button asks Coin Moebius to start a checkout.

  3. Coin Moebius Messages only

    Gets a fresh address from your server and shows it to the buyer.

  4. Blockchain

    Carries the coins from the buyer straight to you.

    • Monero
    • Zano
    • Freedom Dollar
    • Bitcoin
    • Bitcoin Cash
  5. Your wallet

    Receives the coins.

  6. Your server

    Sees the payment land in your wallet and tells Coin Moebius the sale is paid. Your keys and balance never leave your server.

    Coin Moebius dashboardSale shows as paid.
  • No buyer data

    Card numbers never reach us. Buyer names, addresses and contact details are stripped before a sale is saved.

  • Where our bill comes in

    The payment goes to you. Our bill comes separately. On Flex, that bill is based on the sales you’ve made, at 2% + 20¢ each. Pro starts at $24 a month with 500 sales included, then a few cents for each extra sale. Business is $99 a month for unlimited sales. Your provider’s fees are separate from ours.

Why we ask for each field

Your Monero server address

When a buyer clicks Buy, we ask your server for a fresh address to show them. That request goes to this one public route. It hands back an address; your wallet stays private behind it.

Shared secret

Your server sends us a signed message whenever the chain tells it something new about an order. Paid is only one of the things it can say. It also reports money that has arrived and is still settling, an amount that came up short, and an order that expired with nothing sent. This shared secret lets us confirm the message really came from your server, so nobody can forge one. It can read nothing and move nothing.

Set up

  1. Get the Monero app and the tools

    Three free downloads from getmonero.org and nodejs.org. Get all three now.

    1. The Monero wallet app (the GUI wallet). This is where you make your wallet.
    2. The Monero command-line tools (the CLI wallet). This holds the wallet helper you start later. Unzip it, rename the folder to monero-tools, and move it to your Desktop.
    3. Node.js (the green LTS button at nodejs.org). This runs the small server that hands out addresses.
    Download the wallet app
    Download the command-line tools

    The first time you run the command-line tools, your Mac may block them because it does not know the maker. Step 6 shows how to allow them.

  2. Open the app and pick Simple mode

    Open the Monero app. On the Mode selection screen choose Simple mode and leave Portable mode unchecked. Then it explains Simple mode and asks you to agree.

    1. Open the app and continue past the welcome screen.
    2. Choose Simple mode and continue.
    3. Check the box that says you understand a third-party server is used, then click Next.
    Open the Monero app
    Mode selection, choose Simple mode
    Check the box and click Next

    Simple mode borrows a public Monero computer so you do not download the whole blockchain. Your secret words never leave your machine.

    Prefer to run your own node? (advanced)

    To use no outside node at all, choose Advanced mode on this screen instead of Simple mode. Advanced mode runs your own node and downloads the full Monero history first, which takes a while. You also change one line when you start the wallet helper, shown in that step.

  3. Make your wallet

    On the Welcome screen choose Create a new wallet. Then name it, save your words, and set a password.

    1. Choose Create a new wallet (the top choice).
    2. Give it a name and note the folder path it shows. You need that path in step 6.
    3. Write the 25 words on paper, in order, and keep them safe. They are the only key to your money.
    4. Set a password and write it down too.
    5. When the wallet opens, close it. The wallet helper in step 6 needs it closed.
    Choose Create a new wallet
    Name your wallet
    Write down your 25 words
    Set a wallet password
    Your new wallet is ready
  4. Make your secret code

    One shared secret signs and verifies the paid message. Make it once with the command below, or click Generate when you add the provider in the dashboard. Either way, use the same value in both places, and keep it private.

    openssl rand -hex 32
  5. Make your store and copy the id

    Sign in to the dashboard, make a store, and open Store settings. Copy the Store id. It starts with proj_, and the server calls it your project id. You use it when you start the server.

    Copy your Store id
  6. Start the wallet helper

    This program opens your wallet and answers the server. It asks for your wallet password, hidden, so the password never shows on screen and never lands in your command history. Replace YOUR-WALLET-PATH with the path from step 3. In Finder, right-click the wallet file and choose Copy as Pathname, then paste it exactly as given, spaces and all, because the quotes already protect them. Do not drag the file into Terminal, which adds a backslash before each space and makes the wallet look for a name that does not exist.

    1. Go to your tools folder

    cd ~/Desktop/monero-tools

    The next command runs the program sitting in this folder, so it has to be run from here.

    2. Start the wallet helper

    ./monero-wallet-rpc \
      --wallet-file 'YOUR-WALLET-PATH' \
      --prompt-for-password \
      --rpc-bind-ip 127.0.0.1 --rpc-bind-port 18083 \
      --disable-rpc-login \
      --daemon-address nodes.hashvault.pro:18081 --untrusted-daemon
    Mac may block it the first time
    Privacy & Security, Allow Anyway
    The wallet helper is running

    If your Mac blocks it, open System Settings, Privacy & Security, click Allow Anyway, and run it again. On Windows, choose More info, then Run anyway. Leave this window open.

    Using your own node instead of a public one?

    If you chose Advanced mode, start your own node first, then point the wallet helper at it.

    monerod --data-dir ~/.bitmonero --prune-blockchain --restricted-rpc

    Then swap --daemon-address nodes.hashvault.pro:18081 --untrusted-daemon for --daemon-address 127.0.0.1:18081 --trusted-daemon. For real money, keep your spend key offline and run a view-only wallet here.

  7. Download and start the server

    A ready-made server hands out an address for each sale and watches for the money. You do not edit it. Run these one at a time, in the same Terminal window.

    1. Make a folder for it

    mkdir ~/Desktop/coinmoebius-server

    2. Go into that folder

    cd ~/Desktop/coinmoebius-server

    Everything after this runs inside that folder, so keep using this same window.

    3. Download the server

    curl -fsSL https://www.coinmoebius.com/tools/monero-server.mjs -o server.mjs

    4. Start a package file

    npm init -y

    5. Install the two packages

    npm install @aquarian-metals/coin-moebius-monero @aquarian-metals/coin-moebius-server

    This one takes a few seconds and prints a line about how many packages it added.

    6. Start the server

    node server.mjs

    The first run asks two questions: project id and secret code. It saves them next to the file and never asks again. To change one later, edit coin-moebius-monero.json, or delete it to start over.

    Get the ready-made server
    It asks two questions, then runs
  8. Put your server online

    Your server needs a public web address so we can reach it. A free tool called ngrok makes one.

    1. Make a free account at ngrok.com.
    2. Install it. On a Mac, brew install ngrok is the quickest. On Windows, choco install ngrok, or download it from ngrok.com and unzip it.
    3. Add your authtoken (ngrok shows the exact line on its setup page).
    4. Run the command below, then copy the https address it shows next to Forwarding.
    ngrok http 8787
    Copy the ngrok Forwarding address

    If you downloaded ngrok into a folder, run it from there as ./ngrok http 8787. Your free ngrok address stays the same every time you start it.

  9. Connect in the dashboard

    Open Providers, click Connect a provider, choose Be your own provider, then Monero. Paste two things and save.

    1. Your Monero server address: your ngrok address with /coin-moebius/monero/mint added to the end.
    2. Shared secret: the secret code from step 4.
    Connect a provider, Be your own provider
    Search and pick Monero
    Paste the address and the secret

    When you save, we quietly check that we can reach your server. Your wallet helper, server, and ngrok all need to be running.

  10. Add the buy button to your page

    Make a product in the dashboard, then copy its buy button code onto your page. These two pieces go in two different places, so they are separate.

    Near the bottom of the page, just before </body>

    <script src="https://sdk.coinmoebius.com/v3.3.7/sdk.global.js"
      integrity="sha384-cojsaUZyZ/LprY5umW55XCXezNxmxlP57mt+OtLHwuWiEtpNoGvPuiV2xCWWTOek"
      crossorigin="anonymous"
      defer></script>

    One line, once per page, no matter how many buttons that page has.

    Wherever you want the button to appear

    <coin-moebius-buy
      project-id="proj_yourprojectid"
      product-id="your-product"
      amount="59.99"
      currency="USD"
      label="Buy now">
    </coin-moebius-buy>

    Swap in your own Store id and Product reference from the dashboard.

  11. Take your first payment

    This guide sets you up on the real Monero network, so a small real payment is the test. Keep all three windows running (wallet helper, server, ngrok).

    1. Open your page, click Buy, and pick Monero. The window shows an address, a QR code, and the amount.
    2. Send that exact amount of Monero from any wallet.
    3. Wait for confirmations. Monero takes about twenty minutes to fully confirm, by design. The window keeps checking the whole time.
    4. When it shows the payment is complete, your whole setup is working end to end.
    The buy window shows the address
    The payment is complete

After you connect

Your first real payment is the test, and the step above walks through it. Here is what to check while it settles. Keep all three windows running: the wallet helper, the server, and ngrok.

  1. After you pay, the buy window keeps checking on its own. Your buyer never has to refresh.
  2. Monero takes about twenty minutes to fully confirm, by design.
  3. Open the Transactions tab in the dashboard. When the new row reaches Paid, your whole setup is working end to end.

Troubleshooting

Checkout fails right away.

We could not reach your server. Make sure all three windows are running, and that the Monero server address in the dashboard is your ngrok address with /coin-moebius/monero/mint on the end.

The wallet helper says no connection to daemon.

The public Monero node is busy. Open monero.fail, pick another node, put it after --daemon-address in the step 6 command, and start the wallet helper again.

The buyer paid but the order still says Awaiting.

That is normal while the payment confirms. Once the money is on the chain the buy window says the payment was received and is waiting on the network, and it turns into paid at ten confirmations, about twenty minutes after it lands.

It still says Awaiting after thirty minutes.

Either the server is not running, or its secret does not match. Confirm the server is up and that the secret you typed matches the Shared secret in the dashboard.

Good to know

Run it on a computer that stays on. The test runs on your own computer. For an everyday store, run the same parts on a computer that stays on all the time, with a fixed web address.

Short downtime is cheap. The server catches up after a short outage and reports the payments it missed. It looks back about an hour. A payment that landed earlier than that is not reported, and its order stays at Awaiting.

Keep a view-only wallet for real money. When you sell for real, keep your spend key on a separate offline machine and run a view-only wallet on the machine that faces the internet.

Rotating the secret. Make a new secret anytime, then use it in both the server and the dashboard. The server saved the old one, so open coin-moebius-monero.json, change hmacSecret to the new value, and start the server again. The old secret keeps working for 24 hours, so there is no rush.

Monero circular economy

Questions? Join our Discord

Ready to connect a provider?

Pick the providers you already use. Buyers pay through your accounts, and you keep one buy button.