Getting Started¶

Get up and running with Fukuii quickly. Choose the installation method that best fits your needs.

Choose Your Path¶

Docker (Recommended)

The fastest way to run Fukuii in production with signed container images.

Docker Quick Start
GitHub Codespaces

Perfect for development. Get a complete environment in your browser.

Codespaces Setup
Build from Source

Build Fukuii yourself for development or customization.

Build Guide

System Requirements¶

Minimum Requirements¶

Resource	Minimum	Recommended
CPU	4 cores	8+ cores
RAM	8 GB	16 GB
Disk	500 GB SSD	1 TB NVMe SSD
Network	10 Mbps	100 Mbps

Software Requirements¶

DockerSource Build

Docker 20.10 or later
docker-compose (optional)

JDK 21 (OpenJDK or Oracle JDK)
sbt 1.10.7 or later
Git

Required Ports¶

Port	Protocol	Purpose
30303	UDP	Discovery protocol
9076	TCP	Ethereum P2P
8546	TCP	JSON-RPC (internal only!)

Security Notice

Never expose port 8546 to the public internet. See the Security Runbook for details.

Quick Docker Start¶

# Pull the latest signed release
docker pull ghcr.io/chippr-robotics/chordodes_fukuii:latest

# Create data volumes
docker volume create fukuii-data
docker volume create fukuii-conf

# Run the node
docker run -d \
  --name fukuii \
  --restart unless-stopped \
  -p 9076:9076 \
  -p 30303:30303/udp \
  -v fukuii-data:/app/data \
  -v fukuii-conf:/app/conf \
  ghcr.io/chippr-robotics/chordodes_fukuii:latest

Verify Installation¶

# Check if node is responding
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":1}' \
  http://localhost:8546

Expected response:

{
  "jsonrpc":"2.0",
  "id":1,
  "result":"Fukuii/v<version>/..."
}

Next Steps¶

After installation, explore these guides:

First Start Runbook — Complete initial setup
Node Configuration — Customize your node
Security Runbook — Secure your installation
Monitoring Guide — Set up Prometheus and Grafana