Running a node with Bitping is easy, be sure to have an account created here.

Then navigate to the node Install/Update page in the Bitping Dashboard.

You can then follow the step by step instructions below dependent on your operating system and install method.

Bitping Desktop

MacOS 11.0+ Desktop

1. Navigate to the Bitping Install page.
2. Based on which chipset you have, choose either Intel or Apple Silicon and click the download button.
3. Navigate to your Downloads folder in Finder and double click on the Bitping Desktop DMG
4. Drag the Bitping Desktop icon to your Applications folder
5. Open Bitping Desktop from your Applications folder

Windows 10+ Desktop

1. Navigate to the Bitping Install page.
2. Click on the Download button for the Desktop application.
3. Open your downloads folder and double click on the MSI and follow the installation steps.
4. After installation, go to your start menu and click Bitping Desktop

Bitpingd

Linux CLI

1. Install the bitpingd binary with the following script:

   bash curl https://bitping.com/install.sh | bash 

2. Login to the Bitping network:

   bash bitpingd login 

3. To run the node with a display:

   bash bitpingd 

4. If you are setting up the bitpingd service as root/sudo, you will need to run:

   bash bitpingd service install --system && bitpingd service start --system 

5. To run the node in the background as an unpriveliged user: -

   bash bitpingd service install && bitpingd service start 

6. This command will keep your node running in the background when you log out

   bash sudo loginctl enable-linger $(whoami) 

MacOS CLI

1. Install the bitpingd binary with the following script:

   bash curl https://bitping.com/install.sh | bash 

2. Login to the Bitping network:

   bash bitpingd login

3. To run the node with a display:

   bash bitpingd 

4. If you are setting up the bitpingd service as root/sudo, you will need to run:

   bash bitpingd service install --system && bitpingd service start --system

5. To run the node in the background as an unpriveliged user:

   bash bitpingd service install && bitpingd service start

Docker

Option 1. To run the container in interactive mode:

bash docker run -it --mount type=volume,source="bitpingd-volume",target=/root/.bitpingd bitping/bitpingd:latest

Option 2. To run the container and pass email and password via CLI instead of an interactive session run:

1. Log in to your account with the following command:

   docker run -it --mount type=volume,source="bitpingd-volume",target=/root/.bitpingd --entrypoint /app/bitpingd bitping/bitpingd:latest login --email "YOUR_BITPING_EMAIL" --password "YOUR_BITPING_PASSWORD"

2. Now start the bitping node!

   docker run -it --mount type=volume,source="bitpingd-volume",target=/root/.bitpingd bitping/bitpingd:latest

Option 3. Login with environment variables:

docker run -it \
  -e BITPING_EMAIL='YOUR_BITPING_EMAIL' \
  -e BITPING_PASSWORD='YOUR_BITPING_PASSWORD' \
  -e BITPING_MFA='YOUR_BITPING_2FA_CODE' \
  --mount type=volume,source="bitpingd-volume",target=/root/.bitpingd bitping/bitpingd:latest

That’s all. If you need support help with your node, please join our Telegram Group or Email Support.