⚡ Installation workflow

Installing Tajcoin

Unified workflow for all platforms — with AI assistance.
From Raspberry Pi to macOS, get your node running in minutes.

📑 Table of Contents

This document gathers the installation procedures for the Tajcoin wallet across all supported platforms. It also integrates a collaborative workflow designed for AI agents.


🐧 Linux (Ubuntu / Debian)

🌟 Level: ★★☆☆☆ · ⏳ Time: 30–45 min

The Bash script below automates the installation on Debian/Ubuntu (x86_64).

Script install_tajcoin.sh

#!/bin/bash
set -e

# Variables
TAJ_VERSION="v1.1"
BOOTSTRAP_URL="https://github.com/Taj-Coin/tajcoin/releases/download/${TAJ_VERSION}/bootstrap-900600.zip"
QT_ARCHIVE="tajcoin-Qt-20.04-${TAJ_VERSION}.zip"
QT_URL="https://github.com/Taj-Coin/tajcoin/releases/download/${TAJ_VERSION}/${QT_ARCHIVE}"
DATA_DIR="$HOME/.tajcoin"
INSTALL_DIR="$HOME/Applications/tajcoin-qt"

# 1. Install dependencies
echo "📦 Installing dependencies..."
sudo apt-get update
sudo apt-get install -y libqt5gui5 libqt5widgets5 libqt5network5 \
    libboost-system-dev libboost-filesystem-dev \
    libboost-program-options-dev libboost-thread-dev \
    libssl-dev libdb5.3++ libminiupnpc-dev libqrencode-dev \
    wget unzip

# 2. Download and extract the Qt wallet
echo "⬇️ Downloading Qt wallet..."
mkdir -p "$INSTALL_DIR"
cd "$INSTALL_DIR"
wget -O "$QT_ARCHIVE" "$QT_URL"
unzip -o "$QT_ARCHIVE"
chmod +x tajcoin-qt

# 3. First launch (creates the data directory)
echo "🚀 First launch of the wallet (creating $DATA_DIR)..."
./tajcoin-qt -datadir="$DATA_DIR" &

# 4. Clean old chain (if it exists)
if [ -d "$DATA_DIR/blocks" ] || [ -d "$DATA_DIR/chainstate" ]; then
    echo "🧹 Cleaning old chain..."
    rm -rf "$DATA_DIR/blocks" "$DATA_DIR/chainstate" "$DATA_DIR/peers.dat"
fi

# 5. Apply the bootstrap
echo "⬇️ Downloading bootstrap..."
cd "$DATA_DIR"
wget -O bootstrap.zip "$BOOTSTRAP_URL"
unzip -o bootstrap.zip
rm bootstrap.zip

echo "✅ Installation complete. Restart the wallet with: $INSTALL_DIR/tajcoin-qt"

Execution: chmod +x install_tajcoin.sh && ./install_tajcoin.sh

▲ Back to top

🪟 Windows

🌟 Level: ★★☆☆☆ · ⏳ Time: 20–30 min

The PowerShell script below automates the installation on Windows 10/11.

Script install_tajcoin.ps1

# install_tajcoin.ps1
# Automated installation script for Tajcoin Wallet on Windows

param(
    [string]$TajVersion = "v1.1",
    [string]$InstallDir = "$env:LOCALAPPDATA\Programs\Tajcoin"
)

# Directories
$DataDir = "$env:APPDATA\Tajcoin"
$BootstrapUrl = "https://github.com/Taj-Coin/tajcoin/releases/download/$TajVersion/bootstrap-900600.zip"
$QtArchive = "tajcoin-Qt-win64-$TajVersion.zip"
$QtUrl = "https://github.com/Taj-Coin/tajcoin/releases/download/$TajVersion/$QtArchive"

# Console colors
$Green = "Green"
$Yellow = "Yellow"
$Cyan = "Cyan"

Write-Host "=== AUTOMATED TAJCOIN INSTALLATION (Windows) ===" -ForegroundColor $Cyan

# 1. Check privileges
if (-NOT ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) {
    Write-Host "⚠️  It is recommended to run this script as Administrator." -ForegroundColor $Yellow
    $continue = Read-Host "Do you want to continue anyway? (y/N)"
    if ($continue -ne "y") { exit }
}

# 2. Create installation directory
Write-Host "📁 Creating installation directory..." -ForegroundColor $Green
New-Item -ItemType Directory -Force -Path $InstallDir | Out-Null

# 3. Download Qt wallet
Write-Host "⬇️  Downloading Qt wallet..." -ForegroundColor $Green
$QtZipPath = "$env:TEMP\$QtArchive"
Invoke-WebRequest -Uri $QtUrl -OutFile $QtZipPath -UseBasicParsing

# 4. Extract
Write-Host "📦 Extracting archive..." -ForegroundColor $Green
Expand-Archive -Path $QtZipPath -DestinationPath $InstallDir -Force
Remove-Item $QtZipPath -Force

# 5. Verify the .exe exists
$WalletExe = Get-ChildItem -Path $InstallDir -Filter "*.exe" | Select-Object -First 1
if (-not $WalletExe) {
    Write-Host "❌ No executable found in the archive." -ForegroundColor Red
    exit 1
}
Write-Host "✅ Wallet found: $($WalletExe.Name)" -ForegroundColor Green

# 6. First launch (creates data directory)
Write-Host "🚀 First launch to create $DataDir..." -ForegroundColor $Green
Start-Process -FilePath $WalletExe.FullName -ArgumentList "-datadir=`"$DataDir`"" -Wait -WindowStyle Hidden

Start-Sleep -Seconds 3

# 7. Clean old chain (if updating)
if (Test-Path "$DataDir\blocks") {
    Write-Host "🧹 Removing old blockchain..." -ForegroundColor $Yellow
    Remove-Item -Recurse -Force "$DataDir\blocks", "$DataDir\chainstate", "$DataDir\peers.dat" -ErrorAction SilentlyContinue
}

# 8. Download and apply bootstrap
Write-Host "⬇️  Downloading bootstrap (may take a while)..." -ForegroundColor $Green
$BootstrapZip = "$env:TEMP\bootstrap.zip"
Invoke-WebRequest -Uri $BootstrapUrl -OutFile $BootstrapZip -UseBasicParsing

Write-Host "📦 Extracting bootstrap to $DataDir..." -ForegroundColor $Green
Expand-Archive -Path $BootstrapZip -DestinationPath $DataDir -Force
Remove-Item $BootstrapZip -Force

Write-Host "`n✅ INSTALLATION COMPLETE!" -ForegroundColor Green
Write-Host "👉 Launch the wallet from: $($WalletExe.FullName)" -ForegroundColor Cyan
Write-Host "👉 Data directory: $DataDir" -ForegroundColor Cyan

# 9. Create desktop shortcut
$DesktopPath = [Environment]::GetFolderPath("Desktop")
$ShortcutPath = Join-Path $DesktopPath "Tajcoin.lnk"
$WScriptShell = New-Object -ComObject WScript.Shell
$Shortcut = $WScriptShell.CreateShortcut($ShortcutPath)
$Shortcut.TargetPath = $WalletExe.FullName
$Shortcut.WorkingDirectory = $InstallDir
$Shortcut.Save()
Write-Host "✅ Desktop shortcut created." -ForegroundColor Green

Execution: Open PowerShell as administrator and run .\install_tajcoin.ps1.

▲ Back to top

🍎 macOS

🌟 Level: ★★★★☆ · ⏳ Time: 2–4 h

No pre-compiled binaries are officially distributed for macOS. Compilation is required.

Automated compilation script build_tajcoin_macos.sh

#!/bin/bash
set -e

echo "🔧 Installing dependencies via Homebrew..."
brew update
brew install boost openssl berkeley-db@4 miniupnpc qrencode qt@5 git

echo "📥 Cloning repository..."
git clone https://github.com/Taj-Coin/tajcoin.git || true
cd tajcoin

echo "⚙️  Configuring with qmake..."
export PATH="/opt/homebrew/opt/qt@5/bin:$PATH"
qmake tajcoin-qt.pro RELEASE=1

echo "🛠️  Compiling (this may take a while)..."
make -j$(sysctl -n hw.ncpu)

echo "✅ Compilation complete!"
echo "👉 Launch the wallet with: ./tajcoin-qt"

Execution: chmod +x build_tajcoin_macos.sh && ./build_tajcoin_macos.sh

⚠️ Complexity & AI assistance: macOS compilation is the trickiest. AI agents like Claude Cowork can guide you step by step, resolve linking errors, and adjust paths according to your architecture.

▲ Back to top

🍓 Raspberry Pi (ARM64)

🌟 Level: ★★☆☆☆ · ⏳ Time: 15–30 min

Official ARM64 binaries are available as a .deb package or a ZIP archive.

Option A – Install via .deb (recommended)

wget https://tajafrica.pro/Applications/tajcoin-qt_1.1.0.0-1_arm64.deb
sudo dpkg -i tajcoin-qt_1.1.0.0-1_arm64.deb
sudo apt-get install -f   # if dependencies are missing
tajcoin-qt

Option B – ZIP Archive (graphical)

wget https://tajafrica.pro/Applications/tajcoin-qt_1.1.0.0-1_arm64.zip
unzip tajcoin-qt_1.1.0.0-1_arm64.zip -d ~/tajcoin
chmod +x ~/tajcoin/tajcoin-qt
~/tajcoin/tajcoin-qt

Option C – Headless daemon (no GUI)

wget https://tajafrica.pro/Applications/tajcoind_1.1.0.0-1_arm64.zip
unzip tajcoind_1.1.0.0-1_arm64.zip -d ~/tajcoin-node
chmod +x ~/tajcoin-node/tajcoind
~/tajcoin-node/tajcoind -daemon
~/tajcoin-node/tajcoin-cli getinfo
▲ Back to top

🤖 AI Workflow — Assisted Installation

This workflow is designed for AI agents (Claude, Grok, Gemini, etc.) to guide the user step by step, solve problems, and automate repetitive tasks.

💡 For macOS users: Compilation can be lengthy and fraught with pitfalls. Claude Cowork can take over: it will analyze errors, adjust compilation flags, and even execute commands via terminal integration.

📌 Workflow structure

⏺️ Question: "I'm on macOS M2, compilation fails with 'library not found for -lboost_system'. What should I do?"

🌟 Level: ★★★☆☆ · ⏳ Time: 15 min

Agent's response: Let's check the Boost path. On Apple Silicon, it's in /opt/homebrew/lib. Run qmake with BOOST_LIB_PATH=/opt/homebrew/lib.

— Claude 🇫🇷, August 18, 2026

▲ Back to top

📊 Summary & Decisions

Action / Decision 🌟 Difficulty ⏳ Time Status Priority Responsible
Write Bash script for Linux★★☆☆☆1h✅ ValidatedHighClaude
Write PowerShell script for Windows★★☆☆☆1h✅ ValidatedHighClaude
Write macOS compilation guide★★★★☆2h✅ ValidatedMediumClaude
Raspberry Pi installation guide★★☆☆☆30min✅ ValidatedHighClaude
Test Windows script on Win10/11★☆☆☆☆30minTo doHigh
Test compilation on macOS Intel & Apple Silicon★★★☆☆1h eachTo doMedium
Test installation on Raspberry Pi 4/5★☆☆☆☆30minTo doHigh
Add SHA256 verification for archives★★☆☆☆30minOptionalMedium
Create Chocolatey package for Windows★★★☆☆2hOptionalLow
Create Homebrew package for macOS★★★★★4hOptionalLow
▲ Back to top

🧠 Agents Memory & Tools

Active agents

Persistent instructions

Connected tools

▲ Back to top

Version: 2.1 · Last updated: August 18, 2026 · Next review: in 7 days or after a major feature

Exported from Bran's Memory — Living multi-AI document

💡 A 📋 Copy button appears at the top right of each code block. Click it to copy the code.