Quick Guide: OCEAN's DATUM Gateway

Updated

Overview

Install OCEAN's DATUM Gateway on your Pickaxe host from the Pickaxe page, so your site builds its own block templates and mines to OCEAN without a manual Linux setup.

DATUM is OCEAN's technology for building block templates on site while still mining in a pool. A Bitcoin Core node on your own hardware picks the transactions your fleet works on, and the local DATUM Gateway hands out work to your miners over your local network. Traffic between the gateway and OCEAN is encrypted, unlike Stratum V1, and no miner firmware changes are needed.

Running DATUM brings several advantages:

  • Half the pool fee. Miners that build their own templates with DATUM pay OCEAN's 1% fee instead of the standard 2%.
  • Fewer stale shares. Your node peers directly with the Bitcoin network and the gateway delivers new jobs locally, so miners spend less time on stale work. OCEAN estimates stale-share and bandwidth savings of 0.24 to 1.59 BTC per year for a 1 EH/s operation compared with direct-to-pool Stratum V1. This is a modeled range, not a guaranteed return.
  • Less bandwidth. The gateway combines all miner connections into one upstream connection, cutting bandwidth by about 96%. This applies to day-to-day mining traffic, not the one-time chain download described below. Remote sites on Starlink or 5G benefit most.
  • Rewards you can verify. OCEAN's reward accounting shows how each block reward is distributed, down to the shares used in the calculation.

The Foreman installer handles three things for you:

  • Checks that your Pickaxe host meets the hardware, OS, and network requirements before anything is installed.
  • Installs Bitcoin Core (pruned) and DATUM Gateway, then configures both from the selections made in Foreman.
  • Shows install and sync status on the Pickaxe page, and once installed, allows you to access your OCEAN DATUM dashboard.

Before you begin

Your Pickaxe host must pass all six compatibility checks below, or the Install button stays disabled. Foreman runs the check automatically about every five minutes while DATUM is not installed.

Check Requirement
Operating system Linux Debian 13 "Trixie", Ubuntu 24.04 "Noble" or Ubuntu "Resolute". Older releases and other distros are not supported. Windows is not compatible.
CPU cores 4 or more
CPU type 64-bit Intel or AMD (amd64). ARM hosts such as Raspberry Pi, Apple Silicon and Ampere are not supported.
Memory 16 GB RAM or more
Disk size 50 GB total drive size or more
Network Outbound TCP to datum-beta1.mine.ocean.xyz on port 28915

You also need:

  • A Foreman account with access to the site, and a Pickaxe that is online and not a managed Pickaxe.
  • The Bitcoin address OCEAN should pay out to.
  • Enough bandwidth and time for the initial sync. Bitcoin Core downloads the full chain, at least 800 GB today and growing, then keeps about 10 GB on disk as a pruned node. Old blocks are discarded as they are validated, which is why a 50 GB drive can handle an 800 GB download. Sync takes 1 to 4 days depending on hardware, internet connection, and RAM.

Disk space. The disk check looks at total drive size, not free space. Make sure the drive has well over 10 GB free before you start, or the sync can fail partway through.

Metered or satellite internet. The 800 GB download counts against data caps. Plan the install for a connection without a cap, or check your plan first.

Install DATUM from Foreman

The install starts from the Pickaxe card and runs on the host without any terminal work on your side.

  1. In Foreman, open the Pickaxe page and find the card for the host you want to use.
  2. Click Install DATUM. If the button is gray, hover over it to see why the host is ineligible, or open the modal and expand Compatibility Check to see which of the six checks failed.
  3. Review the Bitcoin Node panel. It shows the download size, the storage kept after sync and the estimated sync time.
  4. Fill in the basic settings. New installs open in basic mode, which needs only:
    • Bitcoin address: the address OCEAN pays your rewards to. If you already mine to OCEAN, use the same address so your earnings stay under one account.
    • Coinbase tag: an optional label written into blocks your site finds.
  5. Basic mode fits most sites. Switch to Advanced only if you need to change ports, database cache or other DATUM Gateway and Bitcoin Core settings.
  6. Turn on all three Terms of Use toggles.
  7. Click Install and confirm that you understand the bandwidth and storage use.

Within a few minutes, the Pickaxe card changes from pending to installing. A progress bar then shows Bitcoin Core sync progress to two decimal places. The DATUM Gateway cannot hand out work until the node is fully synced, so expect the card to sit in the syncing state for one to four days.

Card states

Pill Meaning
Blue Install DATUM The host passed all checks and is ready to install.
Gray Install DATUM The host is ineligible or has not reported a check yet. Hover for the reason.
DATUM pending Foreman saved your settings and is waiting for the host to start the install.
Progress bar DATUM is installed and Bitcoin Core is syncing. Miners can't use the gateway yet. This lasts 1 to 4 days.
Green DATUM installed DATUM is installed. The card shows running or stopped, plus a link to the DATUM Gateway dashboard.
Red DATUM is installed but failing. See Troubleshooting below.

Change settings or uninstall

Use the DATUM dropdown on the Pickaxe card. Configure reopens your saved settings in advanced mode. Uninstall DATUM removes the gateway and node within about 15 minutes. The chain data stays on disk, so a later reinstall skips the full download. If you click Install DATUM again within about 10 minutes, the uninstall is cancelled.

Point your miners at DATUM

Once the card shows DATUM installed and running, move one miner first, confirm it is credited on OCEAN, then move the rest.

The gateway listens on port 23334 of the machine running Pickaxe. Use that machine's IP address on the network your miners are on. The stratum URL is:

stratum+tcp://<pickaxe-host-ip>:23334

Use Foreman's Change Pools bulk command to repoint miners. The ${miner.account}.${miner.worker} variables keep each miner's existing account and worker name, so you can update a whole site in one command:

Slot URL User Password
Pool 1 stratum+tcp://<pickaxe-host-ip>:23334 ${miner.account}.${miner.worker} x
Pool 2 stratum+tcp://mine.ocean.xyz:3334 ${miner.account}.${miner.worker} x
Pool 3 Your second fallback pool ${miner.account}.${miner.worker} x

Keeping OCEAN's public stratum in slot 2 means miners fall back to OCEAN directly if the gateway or host goes down.

Check that it works

  1. Open the DATUM Gateway dashboard from the link on the Pickaxe card and confirm the test miner is connected and submitting shares.
  2. On ocean.xyz, look up your payout address and confirm accepted work shows up under the expected worker name.
  3. Run Change Pools on the rest of your selected miners.

Trusted Pools. If you use Trusted Pools, add the gateway URL as a trusted pool before you run Change Pools. Otherwise, Foreman flags the repointed miners, and any trigger that moves miners off untrusted pools will switch them back.

FAQs

Why would I run DATUM instead of mining straight to OCEAN? Miners that build their own block templates with DATUM pay OCEAN's 1% pool fee, half the standard 2% rate. The gateway also hands out work over your local network, which helps reduce stale shares caused by delays from a remote pool. Your own Bitcoin node chooses the transactions your fleet works on.

Do I need separate hardware? No. Bitcoin Core and the DATUM Gateway run on the same host as Pickaxe, as long as that host meets the requirements above.

Can I use DATUM with a pool other than OCEAN? No. DATUM is a different protocol from Stratum, and the pool must support it. The Foreman installer connects to OCEAN only.

Why does it download 800 GB if it only keeps 10 GB? Bitcoin Core has to download and validate the whole chain once to build a trusted copy of the current state. After validation, the pruned node discards old blocks and keeps about 10 GB.

Can I copy the chain from a node I already run to skip the download? Not through the Foreman installer today. Even over a LAN, revalidating the chain still takes hours.

Can I mine through the gateway while the node is syncing? No. The gateway cannot produce valid work until the node is fully synced. Keep your miners on their current pool until the card shows DATUM installed and running.

What happens if the Pickaxe host goes offline? Miners on the gateway lose their primary pool and move to the next slot. Keep OCEAN's public stratum or another pool as a fallback so they keep hashing.

Who gets paid when several miners use the gateway? Rewards go to the Bitcoin address you set during install. Miner usernames come through as worker names so you can see each one on OCEAN.

Can I install DATUM on more than one Pickaxe? Yes, if each host passes the compatibility check. Each host runs its own node and does its own initial sync.

Does DATUM make my fleet more secure? DATUM encrypts traffic between your site and OCEAN. Pair it with Foreman's Trusted Pools and Pool Change Approval so a compromised login cannot quietly repoint your miners.

Can I uninstall and reinstall later? Yes. Uninstall from the Pickaxe card's DATUM dropdown. Chain data stays on disk, so a reinstall skips the long download. You will need to accept the Terms of Use again.

Troubleshooting

Most install failures come from the compatibility check or a blocked firewall port.

Symptom What to do
Install button is gray Open the modal and expand Compatibility Check to see the failed check. The host re-checks about every five minutes, so fixes show up without a restart.
Network check fails Allow outbound TCP from the Pickaxe host to datum-beta1.mine.ocean.xyz on port 28915. Firewall rules are the most common cause.
Memory check fails on a 16 GB machine The OS can report slightly under 16 GB because some memory is reserved. Run the precheck command below to see the exact reason.
Card stuck on DATUM pending Confirm the Pickaxe is online. If it still does not move, choose Uninstall DATUM from the dropdown and install again.
Sync stops or the card turns red Check free disk space on the host. The disk check looks at drive size only, so a nearly full drive can pass and then run out during sync.
Miners won't connect to the gateway Confirm the card shows running, the node has finished syncing, and port 23334 is reachable from the miner network.

Still stuck? Contact Foreman support with your Pickaxe ID and the precheck output.

 

 

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Can't find what you're looking for?

Our support team can help with setup, hardware and billing questions.

Contact Support