Skip to content

Installation Guide

Terminal window
# GitHub (Primaty)
curl -fsSL https://raw.githubusercontent.com/itzcozi/coderaft/main/install.sh | bash
# Mirror (CDN)
curl -fsSL https://coderaft.ar0.eu/install.sh | bash

This script will automatically:

  • Check system compatibility (Debian/Ubuntu only)
  • Install Go, Docker, make, and git if needed
  • Clone the repository and build coderaft
  • Install coderaft to /usr/local/bin
  • Set up proper permissions

Already done here? Head over to the Quick Start Guide to learn how to use coderaft.


If you prefer to build coderaft manually or the automatic script doesn’t work for your system:

Terminal window
sudo apt update \
&& sudo apt install -y docker.io golang-go make git \
&& sudo systemctl enable --now docker \
&& sudo usermod -aG docker $USER
# Note: log out/in (or run `newgrp docker`) for group changes to take effect.
Terminal window
# Clone the repository
git clone https://github.com/itzcozi/coderaft.git
cd coderaft
# Build the binary
make build
# Install to system (requires sudo)
sudo make install

  • Project files: ~/coderaft/<project>/ (on host)
  • Island workspace: /workspace/ (inside Island)
  • Configuration: ~/.coderaft/config.json

Now that you have coderaft installed, quickly get started by following the Quick Start Guide.