Get started

For first-timers

Q: Why so many steps the first time?

BITFUC is a C++ program, not a phone app. CMake, a compiler, Boost, and libevent are the tools that turn the source into bitfucd. You install those tools once. After that, starting the wallet is one script. We do not offer a one-click installer from this website, because then you would have to trust a binary we served.

Q: Why does the build still say bitcoin?

BITFUC is a Bitcoin Core derivative. Source files keep Core’s names. The programs you run are bitfucd and bitfuc-cli. They will not connect to Bitcoin.

Q: cmake: command not found

Install the build tools first. On a Mac: xcode-select --install, then brew install cmake boost libevent. On Linux: install cmake, g++, libboost-dev, libevent-dev, libsqlite3-dev. Then run the cmake lines again.

BITFUC is not an app you download from this website and log into. First-time setup is: install build tools (CMake and friends), copy the source, compile, then open the public-chain wallet on this computer. There is no account here. Nobody at bitfuc.com can see your coins.

Think of it like installing a small program that is both the bank and the wallet. The website is only the instruction sheet.

What you need

A Mac or Linux computer (on Windows, use WSL so the same commands work).
A few gigabytes of free disk and 20–40 minutes the first time (you are compiling a program). Later starts are quick.
The Terminal app (Mac: Spotlight → “Terminal”. Linux: your usual terminal).

The idea in four sentences

Tools — a compiler and CMake. Needed once so this computer can build software. Not the coin itself.
Clone — download the BITFUC source folder with git.
Build — turn that source into bitfucd (the node) and bitfuc-cli (the remote control).
Run — start the public chain and open the wallet on this computer.

Do this

Install the build tools (first time only)

If cmake --version already prints a number, skip this step. If it says cmake: command not found, you are here.

Mac:

xcode-select --install
# if brew is missing: https://brew.sh  then:
brew install cmake boost libevent
cmake --version

Linux (Debian/Ubuntu):

sudo apt-get update
sudo apt-get install -y git cmake g++ libboost-dev libevent-dev libsqlite3-dev pkg-config
cmake --version

Windows: install WSL (Ubuntu), then use the Linux lines. These packages are a compiler toolchain. They are not BITFUC, and you only need them to compile once (or after you change the source).

Copy the source

git clone https://github.com/amperedusk/bitfuc.git
cd bitfuc

This site does not host a one-click installer and it does not collect keys.

Build the node (once)

Paste these two lines. The first run is slow. When it finishes you should have build/bin/bitfucd and build/bin/bitfuc-cli.

cmake -B build -DENABLE_IPC=OFF -DBUILD_GUI=OFF -DINSTALL_MAN=OFF
cmake --build build --target bitfuc

That writes build/bin/bitfucd and build/bin/bitfuc-cli. While it compiles you will still see bitcoin in filenames — that is the engine (Bitcoin Core). You are not installing Bitcoin. When it finishes, run bitfucd, not bitcoind.

Open the wallet

Addresses look like fuc1…. Leave the Terminal window open (Ctrl-C stops it).

./scripts/mainnet/start-operator.sh
./scripts/ui/start-mainnet.sh

Browser: http://127.0.0.1:8766. RPC stays on this computer. Optional: peer with another node using an address from docs/mainnet-peers.md — addnode HOST:17333 add. Do not copy wallet.dat between machines. More: Node.

Use it

Receive — copy your fuc1… address.
Mine — a race, not a queue. Mining rewards need 100 extra blocks before they can be spent.
Send — paste a fuc1… address and an amount in FUC (not Bitcoin bc1).
Backup — copy the wallet file and keep it like a house key.

More: Wallet · Mine. Want throwaway coins first? That is a different page: Testnet.

Common questions

Why so many steps the first time?

BITFUC is a C++ program you compile, like Bitcoin Core. CMake and the compiler are a toolbox. You install them once so this computer can turn source into bitfucd. After that, starting a wallet is one script. We do not put a downloadable app on this website: then you would have to trust a binary we served, and this site would look like a bank.

Why can’t I just sign up on this website?

Then we would hold your keys. That is a bank. BITFUC is software you run. If this site disappeared, your node would still know your coins.

What does “localhost” / 127.0.0.1 mean?

It is an address that always means “me.” Other people on the internet cannot open your wallet at that URL. Do not port-forward it. Do not paste your seed or backup into a chat.

Why does the build still say “bitcoin”?

BITFUC is a Bitcoin Core derivative. The source files keep Core’s names (bitcoind.cpp, and so on) because that is the licensed engine. The programs you run are bitfucd and bitfuc-cli. They use BITFUC ports, addresses, and genesis — they will not connect to Bitcoin.

cmake: command not found

Step 1 is missing. On a Mac run xcode-select --install, install Homebrew if needed, then brew install cmake boost libevent. On Linux install cmake and the packages in step 1. Then cmake --version should print a number, and you can run step 3.

The build failed.

A library is still missing. Repeat step 1, then the two cmake lines in step 3. On a Mac that is usually Xcode Command Line Tools plus brew install cmake boost libevent.

Nothing opened in the browser.

Open http://127.0.0.1:8766. The script must still be running in Terminal. Scroll up there if it failed. (The practice wallet is on Testnet, not this page.)

Is an ERC-20 or Solana “FUC” this coin?

No. Native BITFUC is this node. A token with the same letters on another chain is a different thing.

Technical notes

CMake ≥ 3.22. First-time Mac: brew install cmake boost libevent. Optional: make -C depends NO_QT=1 NO_IPC=1 instead of system Boost/libevent.

cmake -B build -DENABLE_IPC=OFF -DBUILD_GUI=OFF -DINSTALL_MAN=OFF
cmake --build build --target bitfuc
./scripts/mainnet/start-operator.sh
./scripts/ui/start-mainnet.sh

Public chain: P2P 17333, RPC localhost, UI on 127.0.0.1:8766, addresses fuc1…. Join a peer with addnode HOST:17333 add. See Node. Practice and public testnet (not this page): Testnet.