Decentralized Alternative Templates for Universal Mining

Mine on your own templates.

Step-by-step video guides for installing and configuring the DATUM Gateway. Run your own node, build your own blocks, and still pool your rewards.

Install DATUM

New release · October 10, 2026

DATUM Gateway 0.5.0

The first official release under CONVOY's stewardship, updated for Bitcoin's BLAKE2b proof-of-work change. It is a public beta. Release notes ↗

Block withholding protection

On compatible pools, the Gateway guards against withheld blocks, including blocks lost to bugs.

Resumable connections

A brief drop in the pool connection no longer loses work, and pools can move you to another server.

macOS support

The Gateway now builds on macOS with Homebrew, alongside Linux and FreeBSD.

Separate share stats

The dashboard tracks accepted and rejected shares for your Gateway and for the pool separately.

Ways to install

Ubuntu: the PPA

sudo add-apt-repository ppa:convoymining/datum-gateway
sudo apt install datum-gateway

For Ubuntu 22.04, 24.04, 26.04 and 26.10. To stay on 0.5 when 0.6 arrives, use ppa:convoymining/datum-gateway-0.5 instead. The package installs only the program; set up its config and service as in the Ubuntu video.

StartOS

Use the community registry as in the StartOS video, or sideload the 0.5.0 package.

From source

Clone with git, as the videos do. Don't use GitHub's “Source code” downloads.

git clone https://github.com/CONVOYMining/datum_gateway.git

macOS

Install the dependencies with Homebrew, then build inside the clone:

brew install cmake pkgconf curl jansson libsodium libmicrohttpd argp-standalone epoll-shim
cmake . && make

Before you upgrade

Hasher time rolling is now off by default, because some miner firmware handles it badly. Turn it back on with mining.allow_hasher_time_rolling only if you know your hardware is compatible.
The dashboard asks for your admin password before showing the configuration.
Pools can ask the Gateway to move to another server. datum.migration_max_seconds sets a time limit on this: 1 day by default, or 0 to turn it off.
Shares the pool rejects are logged as errors, except ordinary stale shares.
Fixed: nodes built with libevent 2.1.13 work again, extra_block_submissions.urls works again (broken since 0.2.3), and failed block submissions are reported correctly.

CONVOY

Install DATUM

Mine with CONVOY. Four steps from the CONVOY Get Started guide, shown on six platforms. Official guide ↗

All videos →

Install on Ubuntu

Bitcoin Knots from the official PPA and CONVOY's DATUM Gateway built from source, both running as systemd services.

Install on Debian

Bitcoin Knots via the PPA route from the CONVOY guide and CONVOY's DATUM Gateway built from source, both under systemd.

Install on Fedora

Bitcoin Knots from the official binaries, CONVOY's DATUM Gateway from source, and firewalld opened for miners.

Install on Arch Linux

Bitcoin Knots from the official binaries and CONVOY's DATUM Gateway built with pacman dependencies, both under systemd.

Install on Alpine Linux

Bitcoin Knots compiled from source for musl, and CONVOY's DATUM Gateway built with apk, run directly on OpenRC-based Alpine.

Install on StartOS

No terminal needed: add the mempool.guide community registry, install Bitcoin Knots and the #pow-tagged Datum Gateway, and configure them in the StartOS UI.

How it works

Your node builds the block. The pool shares the reward.

Run a node

Bitcoin Knots or Core, fully synced, on hardware fast enough to validate new blocks quickly.

Tune your templates

Reserve room for the pool's payout transaction and get instant new-block notifications.

Run the Gateway

The DATUM Gateway turns your node's templates into stratum work for your miners.

Point your miners

Your payout address as username, a DATUM port, and the pool's own stratum as failover.

Community

Join the miners who build their own blocks.

Get help in the DATUM support channels on the Bitcoin mining Discord, share node configs and follow the Gateway's development.

Join Discord

FAQ

Before you start

Which platform should I pick?

Choose the operating system your node runs on. Ubuntu and Debian are the most common. Docker suits you if you already run services in containers. StartOS needs no terminal at all. The Gateway also runs on FreeBSD and, since 0.5.0, macOS, though there are no videos for those yet.

Is there a package, so I don't have to build it?

On Ubuntu, yes: install datum-gateway from the PPA. On StartOS, use the community registry or the sideload package. On other systems, build from source as the videos show.

How long does the setup take?

Following a video takes 10 to 20 minutes. The Bitcoin node's first sync takes much longer: several hours to a couple of days, depending on your hardware.