Hardware Deployment

Sometimes you might want to run Bitcart on your own hardware. This is a bit more complicated than using a VPS. But in the end you will get way better security and control over your data.

Note that no matter where you host Bitcart, as your private keys are never required, your data is always safe, you can export and move the data to any server. So if you started on a VPS, you can use our backups feature to create a backup of all your data and restore on your own hardware.


Here are the requirements for running Bitcart on your own hardware:

  1. High-speed internet connection. The faster the better. This is to ensure the speed of invoice detection

  2. Any hardware ever. Yes, that's right! You can use your old PC or basically anything for that. Our minimal requirements are 1 GB RAM and around 10 GB disk. AMD64 hardware is the most tested one, but if needed, refer to our raspberry pi guide

  3. Any linux-based OS would suffice, but using something like Ubuntu 20.04 is the most common choice.

  4. (Optional) Static ip - that's required only if your setting up with your own domain name. If you only plan to use bitcart locally/via tor, this is not needed

  5. (Optional) Domain name - see the note above


This guide assumes that you have static ip set up and your own domain name. If not, refer to the local setup guide.

  • Configure static IP in ubuntu via something like this guide

  • If you have a domain name, create a DNS A record pointing to your static ip address (tip: you can get it if you type whatsmyip in google)

  • Set up port forwarding on your router for ports 80 and 443 to your machine ip address. Every router is different, usually there are guides existing on any model

  • Recommended: install ssh server, configure firewall and fail2ban (to prevent excessive failed logins from random ips on the internet):

sudo apt update
sudo apt install -y openssh-server fail2ban git ufw
sudo ufw allow from to any port 22
sudo ufw allow 80, 443
sudo ufw status
sudo ufw enable

You should replace with your own subnet. This is to allow ssh connections only from your local network. You may not need it.

  • Clone and install Bitcart (replace bitcart.yourdomain.com with the actual domain name):

sudo su -
git clone https://github.com/bitcart/bitcart-docker
export BITCART_HOST=bitcart.yourdomain.com

You may customize additional settings by export'ing more things. For example, use BITCART_CRYPTOS to customize the list of coins enabled. For the full list, see docker deployment page

  • All done! Enjoy your Bitcart instance! If needed, check out backups support on how to restore the data from your previous instance.

Last updated