← Mine

🐧 Mining on Linux

About 20-30 minutes. Tested on Ubuntu/Debian and Fedora — adapt the package commands to your distro. The commands below assume Ubuntu/Debian; Fedora notes are inline.

Step 1 of 5

Install BurritoCoin Core

1

Install build dependencies

Ubuntu / Debian:

sudo apt update
sudo apt install -y build-essential libtool autotools-dev automake \
  pkg-config bsdmainutils python3 libssl-dev libevent-dev libboost-all-dev \
  libsqlite3-dev libdb-dev libdb++-dev libminiupnpc-dev libzmq3-dev \
  libfmt-dev git curl

Fedora / RHEL:

sudo dnf install -y gcc-c++ make autoconf automake libtool pkgconfig \
  openssl-devel libevent-devel boost-devel sqlite-devel libdb-devel \
  libdb-cxx-devel miniupnpc-devel zeromq-devel fmt-devel git curl python3
2

Clone and build

git clone https://github.com/burritocoindev/burritocoin.git
cd burritocoin
./autogen.sh
./configure --without-gui --disable-tests --disable-bench --with-incompatible-bdb
make -j$(nproc)
sudo make install

The build takes 15-30 minutes. The binaries burritocoind and burritocoin-cli end up in /usr/local/bin/.

Want a system-managed setup? The repo includes contrib/vps/setup.sh which installs BurritoCoin as a systemd service with a dedicated user. Run it with sudo ./contrib/vps/setup.sh mainnet after building. See doc/build-unix.md for details.
Step 2 of 5

Configure the Node

1

Create the config file

mkdir -p ~/.burritocoin
nano ~/.burritocoin/burritocoin.conf

Paste in:

server=1
daemon=1
rpcuser=burritouser
rpcpassword=CHANGE_THIS_TO_SOMETHING_RANDOM
rpcallowip=127.0.0.1
rpcbind=127.0.0.1

Replace the password with something strong and random. Save: Ctrl+O, Enter, Ctrl+X.

2

Start the node

burritocoind

You'll see "BurritoCoin server starting". Sync should be quick since the chain is small. Verify it's running:

burritocoin-cli getblockchaininfo
Step 3 of 5

Get a Wallet Address

1

Create a wallet and address

burritocoin-cli createwallet "mining"
burritocoin-cli getnewaddress

Copy the address — you'll need it in step 5.

Back up your wallet: burritocoin-cli backupwallet ~/wallet-backup.dat. Copy that file off your machine. If you lose it, you lose your BRTO.
Step 4 of 5

Install cpuminer-opt

1

Install build dependencies

Ubuntu / Debian:

sudo apt install -y libcurl4-openssl-dev libssl-dev libgmp-dev libjansson-dev

Fedora / RHEL:

sudo dnf install -y libcurl-devel openssl-devel gmp-devel jansson-devel
2

Clone and build cpuminer-opt

cd ~
git clone https://github.com/JayDDee/cpuminer-opt.git
cd cpuminer-opt
chmod +x build.sh
./build.sh

This produces a binary called cpuminer in the current folder.

On a server (no GUI)? Skip the build and grab a static binary from the cpuminer-opt releases page.
Step 5 of 5

Start Mining

1

Run the miner

Replace the password and address with yours:

./cpuminer -a scrypt \
  -o http://127.0.0.1:9226 \
  -O burritouser:YOUR_PASSWORD \
  --coinbase-addr=YOUR_BRTO_ADDRESS

You should see lines like:

[2026-05-03 14:22:01] 8 miner threads started, using 'scrypt' algorithm
[2026-05-03 14:22:05] CPU #0: 14.20 kH/s
[2026-05-03 14:22:09] accepted: 1/1 (100.00%), 113.6 kH/s

You're mining.

2

Optional: run mining in the background

To keep the miner running after you log out, use screen or tmux:

sudo apt install -y tmux
tmux new -s mining
# (run cpuminer command here)
# detach with: Ctrl+B, then D
# come back later: tmux attach -t mining
Found a block? 10 BRTO is added to your wallet. Check with: burritocoin-cli getbalance.
Troubleshooting

Common Problems

"Connection refused" or "JSON-RPC error"

The node isn't running, or the RPC password doesn't match. Check that burritocoin-cli getblockchaininfo works, and that the password in your cpuminer command matches ~/.burritocoin/burritocoin.conf.

"./build.sh: Permission denied"

Make it executable: chmod +x build.sh.

cpuminer-opt build fails on older CPUs

The default build targets modern x86. For older CPUs: ./configure CFLAGS="-O3 -march=native" --with-curl && make -j$(nproc)

How do I stop mining?

Press Ctrl+C in the cpuminer window. Stop the node with burritocoin-cli stop.

Can I mine on a Raspberry Pi?

Yes — cpuminer-opt builds on ARM. Hash rate will be modest (a few kH/s) but the Pi sips power, so it's actually a reasonable always-on mining setup while the network is small.