The Valley in your town
Type the name of your place and look up: the masthead is already yours. Then carry it all away in a zip, and start tonight.
Everything stays here. Name, colours, logo and stops live in your browser: nothing reaches our server. The name only leaves if you press Search, towards OpenStreetMap's Nominatim, and the map asks OpenStreetMap for its tiles.
The workbench that builds your site needs JavaScript. Without it, the steps are below, and everything else is on the software page.
Build your site
Your site, as the software will show it. Only a preview: the links lead nowhere.
What you need to start
Our own estimates, not a quote. Three things: people, a place, a machine. In that order.
- People
- Three. One who keeps the server, one who knows how to talk to shopkeepers, one who organises the monthly evening. Alone you get tired.
- A place
- A bar where they know you. Before anything else, before the server.
- A machine
- 2 GB of RAM, a few GB of disk, one domain name. No node to sync: a small machine will do, for a few euros a month. To see the site tonight your own computer is enough, with Docker.
- Time
- One evening to see the site on your computer. A weekend for the server, on the test network. Months for the first customer who comes back without being asked.
You don't do this for the turnover. In eleven years our ledger counts 5,143 payments and 119 shopkeepers. In 2026, up to 1 November, there are 186 payments. You do it because you like living somewhere you can, and because it's fun.
What Rovereto taught
"Copy our experience, avoid our mistakes and adapt it to your area." Amadori and Vaccari, “How to make a Bitcoin Valley”, Plan ₿ Forum, Lugano 2024
| Move | What to do | The mistake we made |
|---|---|---|
| Start from the bar you already go to | Ask the places where you already drink with your first developers: Amadori says he never went door to door, and then the shopkeepers themselves wanted to copy them. | — |
| Customers first, then shops | Bring people into the place: a new shopkeeper needs an evening in there, not a sticker in the window. | A sales force: a shopkeeper can be convinced, but without customers who pay they lose interest. Since then, no pushing. |
| Let the market decide the discount | People with bitcoin pay once for the selfie, and in euros after that, unless it pays them not to. | At first we advised against it. |
| No halfway house | You take euros or bitcoin, one of the two. | The first system had a slider to take part in euros and part in bitcoin: nobody ever wanted it. |
| Don't wait for politics | You can also start from the top with a city council: Lugano did, and that's another story. | A motion passed, a conference with more than 200 people, and nothing afterwards. |
| Count on the cycles | The tenth place is no longer news, and when the price falls people pay less. If you expect it, it won't get you down. | — |
| The accountant, first | Talk to them before the first payment: that's where projects stall, "usually, if the accountant stops you, you stop", in Padua. | — |
The seven moves
From the Rimini slides, 18 May 2024, under the title The Imitation Game. How to infect your friends, from the easiest to the longest.
- Give bitcoin to your friends, on a wallet they have backed up.
- Sell them bitcoin for cash at 20% more, and buy back right away.
- Explain how to register on an exchange, install the wallet, get the backup done, overcome the objections that keep coming back. Then tell them three more times to back up.
- Open a shop in the centre that buys and sells bitcoin.
- Explain to the people who say "to the moon" why they shouldn't hold fiat any more.
- Start a monthly Satoshi Spritz in the new place.
- Be kind and gorgeous, and everyone will want to be like you.
The fifth is a stage joke. The second and the fourth, if they become a trade, are regulated activities: ask first how it works where you are.
Before you take real money
Start on the test network. So far bitmentor has run on test sites, on signet, where bitcoin are worth nothing; we have also tried the till on the real network, with real payments. Before moving to the real network, the guide in the repository lists eight things to decide first: who can change where the money goes, email, the first real payments with every wallet you recommend, backups, the outside check, access to the admin, the privacy page and opening day.
The software holds no funds. No big online account where everybody's money ends up, and no payment server: each shopkeeper gets paid to their own wallet, with their own Lightning address, and the keys stay theirs. Sales stay on the till's phone or computer.
The thing to know. Whoever controls the server holds the till page in their hands. The owner's till remembers its address and stops if the site gives it a different one, but a tampered page can show the customer a different QR code. That is why shopkeepers must know who runs the server, and check their sales against their wallet now and then. The README in the package has the rest.
The steps, by hand
You can do without the workbench above, starting from the example community.
- Clone github.com/mammadori/bitmentor and copy
examples/communityto a folder of your own. - In
community.ymlwrite name, email, map coordinates and the first three stops. Intheme/theme.cssyour colours. - Rewrite the pages in
pages/itandpages/en. - See the site on your computer, with Python or with Docker: the commands are in the
README. - Get a machine with Docker, point a domain name at its address, fill in
.envand rundocker compose up -d.
If you would rather keep this site alive than make a new one: if it disappears tomorrow.
The software, in detail For those in office Write and tell us how it went