Installation

Installing Dependencies (Git, Docker)

HashCore Proxy is distributed as a set of Docker containers. Before installation, you need to install Git, Docker, and Docker Compose.

Linux (Ubuntu/Debian)

Install Git:

sudo apt-get install git

More about Git installation: git-scm.com

Install Docker and Docker Compose:

# Add Docker's official GPG key
sudo apt-get update
sudo apt-get 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

# Add the repository to Apt sources
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

# Install Docker and Docker Compose
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Verify Docker installation

docker run --rm hello-world

Windows (via WSL2)

Install Docker Desktop. Download and install Docker Desktop from the official website: https://www.docker.com/products/docker-desktop/. After installation, launch Docker Desktop, log in to your Docker account, and ensure that "Engine running" is displayed in the bottom left corner.
Install WSL2 and Ubuntu: Open PowerShell as administrator and execute:

wsl --install
```

This command will install WSL2 and download the Ubuntu distribution. The Ubuntu console will be available in the Start menu. All subsequent commands are executed in this window.

3. **Configure Docker + WSL integration**
In Docker Desktop, navigate to: **Settings → Resources → WSL Integration**, check "Enable integration with my default WSL distro" and click the `Apply & Restart` button.

1. **Install Git and verify Docker.**

In the Ubuntu terminal, install Git and verify Docker (as in the Linux instructions above).

System Requirements

docker-compose.yml file

The `docker-compose.yml` file is required to run Hashcore Proxy. The file describes all services (Stratum Proxy, Grafana, Prometheus, etc.). In most cases, this file does not require changes — it is configured and ready to use immediately after installation. It should only be edited in special circumstances.