How to Deploy SHKeeper: Accept Crypto Payments with WooCommerce in 30 Minutes
SHKeeper supports Bitcoin, Ethereum, USDT, USDC, and 19+ cryptocurrencies with a free WooCommerce plugin. Zero platform fees -- only standard network fees apply.
SHKeeper is a self-hosted cryptocurrency payment processor that integrates directly with WooCommerce through a free plugin. It supports 19-plus cryptocurrencies and stablecoins across multiple networks, charges zero platform fees (network fees still apply), and is fully non-custodial. Here is how to deploy it and connect it to your WordPress store.
Prerequisites
- A VPS or dedicated server: 2 cores, 6GB RAM, 20GB SSD minimum
- Docker and Docker Compose installed
- A WordPress site with WooCommerce (self-hosted)
- A domain pointing to your server
Step 1: Deploy SHKeeper
Clone the SHKeeper repository and deploy:
git clone https://github.com/vsys-host/shkeeper.io
cd shkeeper.io
docker compose up -dStep 2: Configure Wallets
Open the SHKeeper admin panel. Go to Wallets. Add a wallet for each cryptocurrency you want to accept. SHKeeper generates wallet addresses or connects to existing wallets. Configure auto-withdrawals to send funds to a cold wallet at set intervals or when a balance threshold is reached. This keeps the bulk of your funds in cold storage while the hot wallet handles daily transactions.
Step 3: Install the WooCommerce Plugin
In your WordPress admin panel, go to Plugins, Add New. Upload the SHKeeper plugin ZIP file (available free from the SHKeeper GitHub). Activate it. Go to WooCommerce, Settings, Payments. Enable SHKeeper. Enter your SHKeeper instance URL and API key.
At checkout, customers now see a Pay with Cryptocurrency option. They select their preferred coin, and SHKeeper displays the wallet address and QR code. The customer sends the payment, and SHKeeper confirms it on the blockchain. Payment status updates automatically in WooCommerce.
Step 4: Configure Exchange Rates and Commissions
SHKeeper fetches live exchange rates from multiple price sources. You can add a markup percentage if you want to cover exchange costs or add a small commission. The default is 0 percent, meaning your customer pays exactly the market rate. You can also set a fixed rate to lock in a price regardless of market fluctuations.
Step 5: Test a Transaction
Before going live, switch SHKeeper to testnet mode. Place a test order on your WooCommerce store. Pay with testnet coins. Verify that the payment is detected, the order status updates, and auto-withdrawals work as configured. Switch back to mainnet when testing is complete.
What You Can Accept
With SHKeeper deployed, your WooCommerce store can accept:
- Bitcoin: On-chain and Lightning Network
- Stablecoins: USDT and USDC on ERC20, TRC20, BEP-20, Polygon, Avalanche, Arbitrum, Optimism, and TON
- Other crypto: ETH, LTC, DOGE, XMR, XRP, TRX, BNB, SOL, MATIC, AVAX, TON, DAI, PYUSD
All with zero platform fees (network fees still apply). All non-custodial. All going directly from your customer to your wallet with no intermediary.
VPS1 deploys SHKeeper with WooCommerce integration and wallet configuration. We handle the Docker setup, the blockchain nodes, and the plugin integration. You start accepting crypto with zero platform fees.
More articles
How to Deploy BTCPay Server: Accept Bitcoin Payments with Zero Platform Fees
BTCPay Server lets you accept Bitcoin and Lightning payments with no platform fees. Only standard Bitcoin network fees apply. Here is how to deploy it with Docker Compose.
Self-Hosted Crypto Payment Processors: BTCPay Server, Bitcart, and SHKeeper Compared
Accept Bitcoin and cryptocurrency payments directly with no platform fees, no intermediaries, and no KYC. Here is how BTCPay Server, Bitcart, and SHKeeper compare.
How to Automate Server Setup with cloud-init: Never Manually Configure a VPS Again
cloud-init automates server provisioning on first boot. Here is how to use cloud-config YAML to install Docker, create users, and secure your VPS before you even SSH in.