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:

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

2. Login to the Bitping network:

   bitpingd login

3. To run the node with a display:

   bitpingd

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

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

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

   bitpingd service install && bitpingd service start

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

   sudo loginctl enable-linger $(whoami)

MacOS CLI

1. Install the bitpingd binary with the following script:

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

2. Login to the Bitping network:

   bitpingd login

3. To run the node with a display:

   bitpingd

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

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

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

   bitpingd service install && bitpingd service start

Docker

Option 1. To run the container in interactive mode:

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.