Your infrastructure. Your setup.
One command on a fresh Linux server installs the dashboard, the checkout page and the API on one address. The full guide, including what to do when something fails, is in the documentation.
Requirements
- Operating system
- Ubuntu, Debian, RHEL family, Fedora, Arch or Alpine, amd64 or arm64
- CPU
- 2 cores
- Memory
- 4 GB
- Disk
- 20 GB
- Ports
- 80 and 443 free, or one port behind your own proxy
- Time
- About ten minutes
Point a domain at the server before you run the installer so it can obtain a TLS certificate from Let’s Encrypt. Without a domain it serves plain HTTP on port 80.
The command
curl -fsSL https://github.com/recv-fund/recvfund-scripts/releases/latest/download/install.sh | sudo bash
Run it as a user who can use sudo. It asks for your domain and whether to use the bundled Postgres or one you already run, then starts the services.
| Flag | What it does |
|---|---|
--mainnet | Install against mainnet on both chains. The recv.fund contracts are not deployed on mainnet yet, so on-chain registration works only on the test networks for now. |
--testnet | Install against the test networks. Use this first. |
--update | Move a running install to the images of this installer release. |
--restart | Restart the services without changing anything. |
--reset | Remove the install, including its database. Cannot be undone. |
What happens next
- 01
Open /signup
Visit your server address in a browser. The signup page is available only until the first account exists.
- 02
Create the root account
Email and password. This is the owner account; it cannot be removed or demoted.
- 03
Create a project
A project is one brand or store. It has its own checkout branding, API keys and webhooks.
- 04
Set a hot wallet
Create a hot wallet per chain family, assign it to the project and fund it with a little native token. It pays network fees for sweeps and sends payouts. Registration records it on-chain as the sweeper, so set it up first.
- 05
Connect a wallet and register on-chain
Connect a browser wallet for each chain and sign one registration transaction. On Robinhood Chain it creates your own merchant contract; on Solana it creates your merchant account in the recv.fund program. The wallet that signs becomes the admin key for that registration. The cold wallet you enter (the settlement address) is where swept funds arrive. The fee rate shown before you sign is fixed for that registration.
- 06
Create a test payment link
From the project dashboard, create a payment link, open it, and pay it from a test wallet. Watch it move to filled.
Then add an API key and a webhook endpoint under Developers, and point your application at your server. The API paths are PayRam-compatible. Details in the documentation.