Install Plumb on StartOS
Plumb's StartOS package is a file you sideload; it is not in Start9's Marketplace. It is Leo Haf's Bitcoin Knots package for blocks from 961640 on, with the signed Plumb release inside. It installs as the service bitcoind, as Bitcoin Core and Bitcoin Knots do, so it takes the place of either instead of running beside it.
This package is Plumb 14, built on Bitcoin Knots 29.5.1 and carrying its consensus rules. Upgrade promptly. The filters, their defaults and the switches are those of the plumb13 package.
The package is a pre-release: it has not been tested on a StartOS server yet. If you try it, say how it went (see If something goes wrong).
Before you start
- StartOS 0.4.1 or later. The package needs StartOS 0.4.1; the current release is 0.4.2.1. To see your version, click the StartOS logo in the top bar (its tooltip says Start Menu), then About this server; the Version line shows it. If yours is older, update StartOS first.
- Hardware. The package is built for x86 (Intel or AMD) only. There is no ARM build of it.
- The Bitcoin node you have now. StartOS installs one
bitcoindper server, and Bitcoin Core, Bitcoin Knots and Plumb all install asbitcoind:- None: Plumb downloads and checks the whole chain.
- Leo Haf's Bitcoin Knots for blocks from 961640 on, version 29.4.1 or a later 29.x: Plumb takes over its chain and settings.
- An older build of that Knots package: update it to 29.4.1 or a later 29.x first, from his releases.
- Bitcoin Core, or the Community Registry's Bitcoin Knots (pre-RDTS) or Bitcoin Roots: Plumb cannot take over its data, because none of them follows the chain from block 961640 on. Uninstall it first. That deletes its chain, and Plumb downloads it again.
- PaulsCode's Knots Companion is a separate service, not
bitcoind. Plumb installs beside it and downloads its own copy of the chain; it cannot take over the Companion's.
- Disk. On a disk smaller than 900 GB, a new install prunes old blocks, which turns the transaction index off. A service that asks a pruned node for a block it has dropped gets it through Start9's btc-rpc-proxy. An open pull request, btc-rpc-proxy#33, says the proxy cannot fetch blocks from 961640 on, and Plumb's package has the proxy without that change. Pruned nodes have not been tested on this chain.
Download and check
From the release page, download plumb14_x86_64.s9pk, SHA256SUMS and SHA256SUMS.asc into one folder on your computer. Then, in that folder:
gpg --keyserver hkps://keys.openpgp.org --recv-keys 89F0E41D72CE523F4AA1CDB692CDFFB7C40CD1BA
gpg --verify SHA256SUMS.asc SHA256SUMS
sha256sum -c SHA256SUMS
Sideload nothing until gpg says Good signature from "Jason Sopko <[email protected]>" and sha256sum says OK. gpg also warns that the key is not certified with a trusted signature. That is expected: it means no key you trust has signed it.
These commands are for Linux. On a Mac, install GnuPG and use shasum -a 256 -c SHA256SUMS for the last one. On Windows, Gpg4win provides gpg, and certutil -hashfile plumb14_x86_64.s9pk SHA256 prints the hash to compare with the one in SHA256SUMS.
Install
- Open your server's StartOS page in a browser and click Sideload in the top bar (the upload icon). On a phone, Sideload is under More in the tab bar.
- Drop
plumb14_x86_64.s9pkonto the box that says Upload .s9pk package file, or click Select and choose it. - StartOS shows Plumb's page from the file, with the warning "This service package isn't signed by anyone you trust." That is expected: Plumb's package is signed with its own key, not one your server trusts. Click Install if no Bitcoin node is installed, Switch if Bitcoin Knots is, or Update if an earlier Plumb package is.
- StartOS asks Install untrusted software? Click Install anyway. Keep the browser tab open while the file uploads.
- StartOS goes to Services. Open Plumb. If its Dashboard shows a Start button, click it. On a new install, the first start downloads and checks the whole chain.
If another service on your server needs bitcoind and would not accept Plumb, StartOS warns that it "will no longer work properly and may crash" and asks you to Continue or Cancel.
Switching from Bitcoin Knots
When you click Switch, StartOS stops Knots, takes a snapshot of its data to roll back to if the switch fails, and brings Plumb up on the same chain and settings, running or stopped as Knots was. There is no need to stop Knots first.
Leo Haf's packages from 29.5.0:5 on use Start9's separate I2Pd service for I2P; Plumb's package still runs its own I2P router. After a switch from one of them, I2P is off until you set I2P SAM Proxy to Enabled under Actions & Config, Peer Settings.
To go back, download bitcoind.s9pk from Leo Haf's releases, release v29.4.3.knots20260508 (package version 29.4.3:1) or later, sideload it and click Switch. StartOS refuses a switch to his packages for Knots 29.4.2: Knots 29.4.2 lets a coinbase mined from block 979919 on be spent after 100 blocks, where Plumb and Knots 29.4.3 and later hold it for 25,920 blocks if it was mined before the median time of the last 11 blocks reached 2027-09-01 00:00 UTC.
Check that it is Plumb
- Open Plumb from Services. Its About tab shows Version
#plumb:29.5.1.14:0. - On its Logs tab, the node lists its filters when it starts, one line for each of the five, such as
Plumb filter -rejectfakeoutputs=1 (knots#389).=1means on. - Plumb's filters are on by default. Only the newest,
-rejectunverifiedwitness, has a switch of its own on the settings screens (below). Under Actions & Config, Mempool Settings, the Max OP_RETURN Size field is empty unless you set it. Empty means Plumb's default of 42 bytes; Bitcoin Knots starts at 83. - On the same screen, Reject Tokens refuses Runes, Counterparty, OLGA, JSON token messages (the BRC-20 format) and Omni Layer. It has three buttons: an X (Off), a minus sign (Default) and a check mark (On); rest the mouse pointer on one to see its name. Default and On keep all five checks on. Off turns all five off, including the JSON and Omni checks that Plumb's
-rejecttokenmessagesfilter controls, although that filter's line in the log still says=1. - Reject Dead Branches and Reject BPUB, on the same screen, set Knots'
-rejectdeadbranchesand-rejectbpub, with the same three buttons. Both are on unless you set them to Off: Default and On keep each on. - Reject Unverified Witness, on the same screen, sets Plumb's
-rejectunverifiedwitness, with the same three buttons. It counts the bytes of P2WSH, P2SH-P2WSH and tapscript witness items that no verified signature check used, past 42 per input, as data carrier bytes. It is on unless you set it to Off, and then its line in the log says=0.
cesspool.lol/check lists the other settings it recommends, with their names on StartOS.
Services that need a Bitcoin node
StartOS checks each service that needs bitcoind against the node installed. Plumb's package declares that it satisfies Bitcoin Knots 29.5.0:3, 29.4.3:1 and 29.4.2:3, so a service that accepts any of them accepts Plumb. The service's Dependencies card says Satisfied, or Incompatible version if it does not accept Plumb. No service has been tested with Plumb on StartOS.
Updates and uninstalling
Start9's Marketplace does not carry Plumb, so StartOS does not offer Plumb updates by itself. When a new Plumb package comes out on the releases page, check it and sideload it the same way; the button then says Update. Updating keeps the chain and your settings.
To uninstall, open Plumb's Actions & Config tab and click Uninstall under StartOS. That deletes Plumb's data, including its copy of the chain.
If something goes wrong
- "Invalid package file". The file is damaged or not a StartOS package. Download it again and check it.
- "Version 1 s9pk detected". That file is a package for an older StartOS. Plumb's is not, so it is the wrong file.
- "This service cannot go from ... to ...". The node you have now is Bitcoin Core, Bitcoin Knots (pre-RDTS), Bitcoin Roots or a Knots build older than 29.4.1, and Plumb cannot take over its data as it is (see Before you start). Going back from Plumb, it means the Knots package is older than 29.4.3:1 (see Switching from Bitcoin Knots).
- Plumb installs but does not start or sync. Open its Logs tab. Download there saves the log to a file.
- "Error: maxscriptsize cannot exceed 4294967295" or "Error: bytespersigopstrict cannot exceed 4294967295" in the log. Since Knots 29.5.1, the node stops at startup when Max Script Size or Bytes Per Sigop Strict under Mempool Settings is above 4,294,967,295; the form takes larger numbers. Set the field to 4,294,967,295 or less, or empty it.
- Still stuck. Ask in the Bitcoin Education Hub Discord or open an issue at github.com/plumb-node/plumb. Include your StartOS version, your hardware, the Bitcoin node you had before, the exact error and the log lines around it.