🐧 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

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

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

Create the config file

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

Paste in:

server=1
daemon=1
rpcport=9226
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.

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

Create a wallet and address

burritocoin-cli createwallet "mining"
burritocoin-cli getnewaddress

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

Encrypt the wallet (recommended)

The wallet is unencrypted by default — anyone with shell access can spend your BRTO. Lock it with a passphrase:

burritocoin-cli encryptwallet "PICK_A_LONG_RANDOM_PASSPHRASE"

The node shuts down automatically after this command. Restart it:

burritocoind

Mining still works without unlocking — rewards go to the address you copied. To spend later, unlock first:

burritocoin-cli walletpassphrase "your_passphrase" 60

(60 = seconds before it auto-locks again.)

Wallet passphrase ≠ RPC password. You now have two different secrets. The RPC password (in burritocoin.conf) lets cpuminer talk to the node — that's the one you put in the cpuminer command. The wallet passphrase (just set above) only protects spending your coins. Don't mix them up.

Write the passphrase down somewhere safe. If you forget it, every BRTO in this wallet is gone forever. There's no recovery, and the backup file is encrypted with the same passphrase.

Back up your wallet

Make sure the node is running again (the encryptwallet step shut it down — restart with burritocoind if you haven't). Then:

burritocoin-cli backupwallet ~/wallet-backup.dat

Copy wallet-backup.dat off this machine. If you lose it, you lose your BRTO.

Step 4 of 5

Install cpuminer-opt

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

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

Verify the node is ready

Sanity-check before launching cpuminer:

burritocoin-cli getblockchaininfo
burritocoin-cli listwallets

The first should return JSON with "initialblockdownload": false and blocks ≈ headers. The second is a JSON array — it should contain "mining". If the array is empty ([]), run burritocoin-cli loadwallet "mining". If initialblockdownload is true, wait for sync to finish before mining.

Run the miner

From the cpuminer-opt folder, replace YOUR_PASSWORD with the RPC password from burritocoin.conf and YOUR_BRTO_ADDRESS with the address you copied in Step 3:

./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 of 8 miner threads started using 'scrypt' algorithm
[2026-05-03 14:22:05] CPU #0: 14.20 kH/s
[2026-05-03 14:22:05] CPU #1: 14.18 kH/s
...

You're mining. The kH/s lines repeat continuously — that's normal idle hashing.

If cpuminer errors with rule not supported or error -8: BurritoCoin's daemon requires both segwit and mweb in getblocktemplate's rules array. Most recent cpuminer-opt builds send these correctly. If yours doesn't, update to the latest release from JayDDee/cpuminer-opt or use a fork that supports MWEB rules.

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

"accepted" never appears — is something wrong? No. In solo mining, the accepted: N/N line you may have seen in pool-mining tutorials only appears when you actually find a full block, which on a tiny chain at low difficulty might still be minutes to hours apart. When a block is found, 10 BRTO is added to your wallet — verify 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.