Here are instructions for setting up Dojo and Ashigaru terminal backed by a Bitcoin full node on Ubuntu Server 24.04. With this setup you will be able to coinjoin from home in a self custody fashion without permission and in a private manner.
In these instructions I use a Proxmox LXC, but this should work the same if you are running Ubuntu server on bare metal. I recommend using a Dell Micro Optiplex. These are small and can sit out of the way next to your router. This is a continuation of our Homelab setup guide.

Table of Contents
- What is a Coinjoin?
- Prerequisites
- Install Dojo
- Install Ashigaru Terminal
- Usage and Maintenance
- Conclusion
What is a Coinjoin?
A coinjoin is a way to improve anonymity by combining multiple users’ payments into a single, collaborative transaction. The process mixes inputs from different users and makes outputs of the same amount, making it hard for someone analyzing the blockchain to trace which specific input corresponds to which output.
How It Works
- Basic Concept: Picture 5 people walking into a room, each with an ounce of gold of the same purity. The gold is melted together and 5 gold coins of the same weight each are minted and handed to each person. This is what a coinjoin in Bitcoin is like.
- Mixing Process: For example, if three people each want to send .1 BTC, their inputs are pooled together, and the transaction outputs three .1 BTC amounts to new addresses. Without additional context, it’s unclear which output belongs to which original sender, effectively obscuring the transaction history.

- Trustless Nature: In the case of Ashigaru, users don’t need to trust each other or a central party beyond coordination, as each user always retains custody of their funds.
Why Should You Coinjoin?
A coinjoin works to address one of bitcoins fundamental challenges – everyone can see what happens on the blockchain. Every bitcoin exchange that is following KYC/AML guidelines has your ID and has a record of the bitcoin you’ve purchased and withdrawn into self-custody. At the point you take custody, they can follow the movement of the bitcoin when you spend it.
The Coinjoin Install Prerequisites
I’ve tested this setup a few times in different environments without issue.
Of course you do not need to use Ashigaru Terminal if you are running Ashigaru wallet on Android. If you go that route, setup Dojo and then after the initial block download, connect your Ashigaru wallet using the Dojo Maintenance Tool. You can coinjoin safely from Ashigaru wallet, and spend privately too.
Prerequisites
- Proxmox LXC container (or just run on a PC with appropriate resources) running Ubuntu 24.04.3 LTS with 8 GB RAM and 2 TB storage allocated. Pro tip: add extra ram for the initial block download and then take it back to 8 gb, or even less if you are running in a container.
- User “bitcoin” or choose your own username, but these instructions will assume bitcoin is the user. Adjust username in instructions where needed. All commands below assume you are logged in as the “bitcoin” user with sudo privileges.
- Internet access for downloads and blockchain sync (initial sync may take 2-7 days depending on bandwidth and hardware; HDD will be slower than recommended SSD).
- The setup will install Dojo (which includes Bitcoin Core for the full node), sync the Bitcoin blockchain (~600-700 GB as of 2026), and then install Ashigaru Terminal for Whirlpool coinjoins and wallet management.
- Ashigaru Terminal is a TUI (text-based) Bitcoin wallet companion for privacy-focused coinjoins via Whirlpool. It integrates with Dojo for sovereign, private operation without relying on third-party servers.
Install Dojo
Step 1: Update the System and Install Dependencies
If this is a fresh OS install you are working on, then no need to clean up previous docker versions. Otherwise, run this to uninstall conflicting docker packages.
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)Dojo requires Docker for containerized services, Tor for secure downloads, and other tools for verification and editing. Run these commands to prepare the environment.
Let’s setup required dependencies for Docker and add the repository:
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update- Install Docker Engine and Docker Compose Plugin
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin- Check that Docker is running:
sudo systemctl status docker- Start from boot:
sudo systemctl enable docker- Test Docker:
sudo docker run hello-worldThis should results in a simple docker container that says “Hello world”
- Test Docker Compose:
docker compose versionYou should see an output showing newest version of Docker Compose.
- Let’s make it so you don’t need to use sudo for Docker:
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker- Logout and then back for changes to take effect.
Let’s add TOR and make sure a few other dependencies are working:
sudo apt update && sudo apt upgrade -y
sudo apt install tor torsocks gnupg unzip wget nano -y- Start Tor and enable it on boot (for torsocks to work):
sudo systemctl start tor
sudo systemctl enable torStep 2: Download and Verify Dojo
Dojo is the wallet server backend that runs Bitcoin Core, Fulcrum indexer, Electrum server, and more. Download and verify over Tor for security. In this setup we will be using Bitcoin Core version 29.
- Download the developer’s PGP key and import it:
torsocks wget https://keys.openpgp.org/vks/v1/by-fingerprint/E53AD419B242822F19E23C6D3033D463D6E544F6 && gpg --import E53AD419B242822F19E23C6D3033D463D6E544F6- Download the latest Dojo version (replace
v1.28.2with the latest from https://github.com/Dojo-Open-Source-Project/samourai-dojo/releases if newer):
torsocks wget -O samourai-dojo-1.28.2.zip https://github.com/Dojo-Open-Source-Project/samourai-dojo/archive/refs/tags/v1.28.2.zip- Download the fingerprints file and its signature:
torsocks wget https://github.com/Dojo-Open-Source-Project/samourai-dojo/releases/download/v1.28.2/samourai-dojo-1.28.2-fingerprints.txt
torsocks wget https://github.com/Dojo-Open-Source-Project/samourai-dojo/releases/download/v1.28.2/samourai-dojo-1.28.2-fingerprints.txt.sig- Verify the PGP signature:
gpg --verify samourai-dojo-1.28.2-fingerprints.txt.sig- Look for “Good signature from ‘dojocoder@pm.me’”. Ignore certification warnings. If not good, stop and investigate.
- Hash the downloaded ZIP:
sha256sum samourai-dojo-1.28.2.zip- View fingerprints:
cat samourai-dojo-1.28.2-fingerprints.txt- Compare the hashes from step 5 and 6. They must match exactly. If not, stop.
- Unzip and set up directory:
unzip samourai-dojo-1.28.2.zip -d .
mkdir ~/dojo-app
mv ~/samourai-dojo-1.28.2/* ~/dojo-app/
rm -r samourai-dojo-1.28.2 samourai-dojo-1.28.2.zip samourai-dojo-1.28.2-fingerprints.txt samourai-dojo-1.28.2-fingerprints.txt.sig E53AD419B242822F19E23C6D3033D463D6E544F6Step 3: Configure Dojo
Generate 8 unique, alphanumeric, 40-character credentials using a password manager (e.g., pwgen -s 40 1 for each). You’ll need:
- BITCOIND_RPC_USER
- BITCOIND_RPC_PASSWORD
- MYSQL_ROOT_PASSWORD
- MYSQL_USER
- MYSQL_PASSWORD
- NODE_API_KEY
- NODE_ADMIN_KEY (save this one securely for later access)
- NODE_JWT_SECRET
- Navigate to config directory:
cd ~/dojo-app/docker/my-dojo/conf/- Edit Bitcoin Core config:
nano docker-bitcoind.conf.tpl- Set
BITCOIND_RPC_USER=YourValueHere - Set
BITCOIND_RPC_PASSWORD=YourValueHere - Set
BITCOIND_DB_CACHE=2048(suitable for 8 GB RAM) - Save: Ctrl+X, Y, Enter.
- Edit MySQL config:
nano docker-mysql.conf.tpl- Set
MYSQL_ROOT_PASSWORD=YourValueHere - Set
MYSQL_USER=YourValueHere - Set
MYSQL_PASSWORD=YourValueHere - Save.
- Edit Indexer (Fulcrum) config:
nano docker-indexer.conf.tpl- Set
INDEXER_INSTALL=on - Set
INDEXER_TYPE=fulcrum - Set
INDEXER_BATCH_SUPPORT=active - Set
INDEXER_EXTERNAL=on - Set
INDEXER_EXTERNAL_IP=127.0.0.1(since local container) - Save.
- Edit Node config:
nano docker-node.conf.tpl- Set
NODE_API_KEY=YourValueHere - Set
NODE_ADMIN_KEY=YourValueHere - Set
NODE_JWT_SECRET=YourValueHere - Set
NODE_ACTIVE_INDEXER=local_indexer - Save.
Delete all credentials except NODE_ADMIN_KEY after configuration.
Step 4: Install and Start Dojo (Full Bitcoin Node)
- Navigate to Dojo script:
cd ~/dojo-app/docker/my-dojo- Install:
./dojo.sh install- This starts Bitcoin Core sync and Fulcrum indexing. Logs will stream (node.js, bitcoind, fulcrum).
- Exit logs: Ctrl+C.
- Sync time: 2-7 days. Blockchain data stored in Docker volumes under ~/dojo-app/docker/my-dojo (ensure 2 TB available).
- To start/stop Dojo later:
- Start:
./dojo.sh start - Stop:
./dojo.sh stop - Logs:
./dojo.sh logs
Step 5: Monitor Syncing Status
Navigate to ~/dojo-app/docker/my-dojo for all commands.
- View Bitcoin Core (IBD) logs:
./dojo.sh logs bitcoind- Look for “IBD progress = X.XXXXXX (X%)”. 100% completes IBD.
- Exit: Ctrl+C.
- View Fulcrum logs:
./dojo.sh logs fulcrum- Look for “Fulcrum indexing status = X%”. 100% completes indexing.
- Exit: Ctrl+C.
- For Dojo Maintenance Tool (DMT):
- Get onion URLs:
./dojo.sh onion - Open the DMT onion URL in Tor Browser (install Tor Browser if needed via
sudo apt install torbrowser-launcher -y). - Login with NODE_ADMIN_KEY.
- Status page shows green checks when fully synced (Full Node, Indexer, Tracker, Dojo DB).
Once all green, the full Bitcoin node is ready.
Install Ashigaru Terminal to Coinjoin
Step 6: Download, Verify, and Install Ashigaru Terminal
Ashigaru Terminal is the TUI frontend for coinjoins. You should download over Tor.
- Download binary and signed hashes (replace v1.0.0 with latest from http://ashicodepbnpvslzsl2bz7l2pwrjvajgumgac423pp3y2deprbnzz7id.onion/Ashigaru/Ashigaru-Terminal/releases/):
torsocks wget http://ashicodepbnpvslzsl2bz7l2pwrjvajgumgac423pp3y2deprbnzz7id.onion/Ashigaru/Ashigaru-Terminal/releases/download/v1.0.0/ashigaru_terminal_v1.0.0_amd64.deb
torsocks wget http://ashicodepbnpvslzsl2bz7l2pwrjvajgumgac423pp3y2deprbnzz7id.onion/Ashigaru/Ashigaru-Terminal/releases/download/v1.0.0/ashigaru_terminal_v1.0.0_signed_hashes.txt- Verify (use PGP; key fingerprint A138 06B1 FA2A 676B from ashigaru.rs/download):
- Import key if needed (from site).
- Verify signature (adapt from Dojo steps; use gpg if signed file available).
- Hash binary:
sha256sum ashigaru_terminal_v1.0.0_amd64.deb - Compare to hashes in signed_hashes.txt (verify file signature first).
- Install Ashigaru Terminal:
sudo apt install ./ashigaru_terminal_v1.0.0_amd64.deb- Verify install:
/opt/ashigaru-terminal/bin/Ashigaru-terminal --version- Launch Ashigaru Terminal:
/opt/ashigaru-terminal/bin/Ashigaru-terminal- Navigate with arrows/Enter in TUI.
Step 7: Connect Ashigaru Terminal to Dojo (Private Electrum Server)
For privacy, connect to your local Dojo’s Fulcrum Electrum server.
- Get Fulcrum onion/port:
./dojo.sh onion(from Dojo dir). Note the Fulcrum onion (e.g., xxxx.onion:50001). - In Ashigaru Terminal TUI:
- Go to
Preferences > Server. - Select
< Edit >. - Choose
Private Electrum Server > Continue. - Enter URL:
127.0.0.1:50001(usetfor TCP, or use 50002 and ssl). - Select
< Test >. Look for “Success”.
- Create/restore wallet:
Wallets > Create / restore wallet....- Name it, select
Hot Wallet. - Generate new (backup mnemonic + passphrase) or import.
- Set strong password.
Step 8: Coinjoin Server Usage and Maintenance
- Use Ashigaru Terminal for Tx0 (premix), mixing, and remixing via Whirlpool.
- Spend postmix via synced mobile app (Ashigaru Mobile, not covered here).
- Backup: Store Dojo credentials/mnemonics offline.
- Updates: Check ashigaru.rs for new versions; stop Dojo, update, restart.
- Troubleshooting: Check logs (
./dojo.sh logs), ensure ports open (local only), monitor disk usage (df -h). - Security: Run over Tor, avoid public servers, prune blockchain if space tight (edit bitcoind config:
BITCOIND_PRUNE=550).
Conclusion
If you’ve made it this far, then nice job setting up your coinjoin bitcoin node!
A few call-outs: by default Ashigaru is blocking connections to bitcoin knots nodes. You can easily turn that off if you prefer. Also, Dojo is working to avoid connecting over clearnet, even when you are on your home network. In a future post we will go over connecting over your home network so that you can use your node with other apps at home, like sparrow wallet. We might take a look at Tailscale for using your node over clearnet away from home too.
Again, it is really easy to download and install Ashigaru wallet on Android and connect to your node over Tor, so this might be the best way to go.
This setup provides a private, full Bitcoin node with coinjoin capabilities. You should familiarize yourself with the docs at ashigaru.rs/docs in case issues come up.

