# Software Installation

Whether you [build-your-own-device-diy](https://docs.trafficmonitor.ai/build-your-own-device-diy "mention") or buy a pre-built unit, these are the instructions to perform a fresh install.

### Preparation

{% hint style="success" %}
**Raspberry Pi OS 64-bit Lite install** is the recommended default and is the basis for the software. The 64-bit Full Install will provide a desktop environment and extra packages that are not used by the Traffic Monitor.

Find it on RPi Imager by navigating to *Operating System > Raspberry Pi OS (other) > Raspberry Pi OS Lite (64-bit)*.
{% endhint %}

1. Install Raspberry Pi OS (64-bit lite) using [RPi Imager](https://www.raspberrypi.com/documentation/computers/getting-started.html#install-using-imager) (read the [RPi getting started](https://www.raspberrypi.com/documentation/computers/getting-started.html#installing-the-operating-system)).
   * You will need an SD card or microSD card reader on your host machine.
   * (*Recommended*) [OS customization](https://www.raspberrypi.com/documentation/computers/getting-started.html#advanced-options) to set up your WiFi credentials and username and password to access the device headless; i.e. SSH with no monitor or keyboard.
2. Insert the microSD card into the Raspberry Pi and boot.
   * Note: The first boot may take several minutes before it is fully online.

### Install the Traffic Monitor software

{% hint style="warning" %}
*An internet connection* is required to install system dependencies, build the required Docker containers, download drivers, and more. After installation, the traffic monitor can run fully offline.
{% endhint %}

{% hint style="info" %}
The Traffic Monitor software is installed via an [Ansible](https://github.com/ansible/ansible) deploy script. This allows you to perform a [local installation](#local-installation) or [remote installation](#remote-installation) from a host computer to 1 or more devices simultaneously!
{% endhint %}

#### Local installation

(*Most common installation method*)

1. [Connect to your device](https://docs.trafficmonitor.ai/setup-guide#id-1.-connect-to-your-device) and executing the following commands via a terminal:
   1. `sudo apt update && sudo apt install -y git`
   2. `git clone https://github.com/glossyio/traffic-monitor`
   3. `bash traffic-monitor/script/tmsetup.sh`
2. Follow instructions and restart when prompted.

#### Remote Installation

Install the TM software to 1 or more devices simultaneously using our Ansible deploy script. This allows you to deploy or update a whole fleet of Traffic Monitors with common configuration files in a single command!

{% hint style="success" %}
Before you can perform remote installation, ensure the following:

1. Your host machine is able to run `bash` commands (Linux or Mac)

2. Raspberry Pi OS is installed on each device

3. The traffic monitor device is running and online

4. You have the device IP address(es) or resolvable host name(s) from your host to the device(s)
   {% endhint %}

5. On your host machine, download TM[^1] OSS[^2] software and set up any configurations you want to send:
   1. `git clone https://github.com/glossyio/traffic-monitor`

6. Run the install script from your host machine with your device IP address(es) space-separated with `-H`, enter username specified on OS setup (needs to be the same across all devices) with `-l`, and prompt for password with `-k`:
   1. `bash traffic-monitor/script/tmsetup.sh -H <ip_address> -l <ssh_username> -k`

7. Continue to [deployment-and-mounting-guide](https://docs.trafficmonitor.ai/deployment-and-mounting-guide "mention") and [setup-guide](https://docs.trafficmonitor.ai/setup-guide "mention") for each device.

### Next Steps

1. Deploy your device: See the [deployment-and-mounting-guide](https://docs.trafficmonitor.ai/deployment-and-mounting-guide "mention").
2. Set up zones, location, and enable your sensors: See [setup-guide](https://docs.trafficmonitor.ai/setup-guide "mention").
3. Start capturing roadway usage data!

[^1]: traffic monitor

[^2]: open source software