Skip to content

Deploying on a Raspberry Pi

Jump to bottom
Paul C. Zimmerman edited this page Sep 23, 2025 · 25 revisions

Why Raspberry Pi?

Raspberry Pi single board computers are popular and inexpensive, and make an excellent platform for running ShootPoints-Web in the field.

Which Models are Supported?

ShootPoints-Web has been used on Raspberry Pi 2 Model B computers on excavations in Iraq. Because of its good balance of small size, reasonable speed, low power consumption, full-sized USB port, and built-in Wi-Fi, I prefer deploying on the Raspberry Pi 3 Model A+, but it will run equally well on any currently-produced model.

What Do These Instructions Do?

The procedure documented below will turn your Raspberry Pi into a headless data collector for use in the field. By following it you will install the latest version of Raspbian OS onto your device, configure it to create a Wi-Fi network called “shootpoints,” and set ShootPoints-Web to run at startup.

Install Rasbian

  1. Download and install the Raspberry Pi Imager app.
  2. Launch Raspberry Pi Imager, and choose the appropriate device.
    Choose Device
  3. Click the “Choose OS’ button and then “Raspberry Pi OS (other).”
    Choose OS
  4. Select the appropriate Lite version of the Raspberry Pi OS based on Debian Bookworm. (For a Raspberry Pi 3 Model A+ this is “Raspberry Pi OS Lite (64-bit).”)
    Choose RPi OS Lite
  5. Choose the storage medium (i.e., the microSD card that you will install in the Raspberry Pi).
    Choose Storage Medium
  6. You will use OS customisation, so click the “Edit Settings” button.
    Edit OS customisation settings
  7. Under the OS Customisation “General” tab set the hostname, username, and password all to “shootpoints” and set your locale.
    OS Customization Settings
  8. Under the OS Customisation “Services” tab enable SSH with password authentication.
    Enable ssh
  9. Save the customizations and then write the image to the microSSD, accepting the fact that any existing data on the storage medium will be lost, and entering your password when prompted.

Install ShootPoints-Web

  1. (optional) Connect the Raspberry Pi to an external monitor with HDMI.
  2. Connect the Raspberry Pi to your local network with ethernet and power it on. (Models without an ethernet port will need a USB to ethernet adapter.)
  3. Wait a few minutes for the device to fully configure itself. If it’s connected to a monitor you can wait until the login prompt appears.
  4. Use ssh to connect to the Raspberry Pi from another computer on the same network. (Window users may need to install Putty first.)
    ssh shootpoints@shootpoints.local
    Note: depending on your network configuration, you may have to connect to the Raspberry Pi with its IP address instead of shootpoints.local.
  5. Run the installation script.
    curl -s https://raw.githubusercontent.com/Lugal-PCZ/shootpoints-web-rpi-installer/main/install-shootpoints-web.sh | bash
  6. Restart the Raspberry Pi
    sudo reboot
    -OR- shut it down.
    sudo shutdown -h now

Next Steps

USB-to-Serial Adapter

Plug a USB-to-serial adapter into the Raspberry Pi to connect it to the total station’s serial cable. For my Topcon total station, I use this USB to hirose cable.

Enclosure

3D print an enclosure for your Raspberry Pi.

Clone this wiki locally