BOB the Universal Object Tracker

Below are the installation instructions for installing BOB, your friendly Object (bird, insect, bat, uap) detector, tracker and recorder The application uses Docker and Docker Compose to run, at present we are still in a very early release phase so this the install process is not polished at all. We will endeavour to improve this over time so please bear with us.

Whilst it is recommended to run on native Linux, it is possible to run Bobcamera on Windows 10 or Windows 11 through WSL (more resource intensive). Please note refer to the Windows setup instructions to prep your machine before running the steps below.

The following steps will need to be performed in a linux terminal

Ubuntu 23.10 has been tested
Ubuntu 22.04 has been tested

1. Install dependencies

Git
Curl

sudo apt-get install git curl

2. Clone the github repo

git clone --recursive https://github.com/bobcamera/bobinstall.git

3. Change directory to bobinstall

cd bobinstall

4. Run the setup script, this will install docker and docker compose

./setup.sh

5. Reboot the machine

Only required if Docker has been installed during the setup script

sudo shutdown -r now

6. Navigate back to the bobinstall directory once rebooted

cd ~/bobinstall

7. To start up BOB

./run.sh

8. Use your system browser and navigate to http://localhost:8080

9. To shut BOB down, type CTRL + C in the terminal

Appendix:

I. To change the configuration after initial setup please execute:

./config.sh

II. To update to the lastest version of bob please execute:

git pull origin main

III. Reset the config file to factory conditions:

cp .env.example .env

./setup.sh

and select "No" in the prompt.