Skip to content

VerCalBot/VerityBot

Repository files navigation

VerityBot

VerityBot is a robust, software solution intended for users who want to make informed security decisions. Using digital sensor data from Verkada -- a premier physical security platform, our application provides detailed, analytical insights into your Verkada system. It is portable, reliable, data-driven, and allows users to feel confident in making important security decisions.

Requirements

Requirement Installation
Docker Desktop Download Here
WSL Prompted during Docker install

Follow this guide to set up Docker Desktop and WSL2 WSL & Docker

Clone the VerityBot git repository into the WSL2 terminal git clone git@github.com:VerCalBot/VerityBot.git

Ensure that Docker Desktop is open and running on your host machine
Docker Running

Search for WSL in Windows and open it Open WSL

Navigate to VerityBot/scripts and run ./initial_setup.sh
Initial Setup

If prompted, confirm you would like to delete existing Cron jobs
Initial Setup

When prompted, enter your User password
User Password

Enter your credentials into the popup dialogue box Note: All fields must be filled, use the Generate Key button to create a Kibana Encryption Key. Note: All passwords must be at least 6 characters long.
Dialogue Box

Click Save and exit the popup box
Dialogue Box

When prompted, confirm you would like to continue and enter the password for kibana_system. Note: This should be the same password as the one you placed in the popup for Kibana Password.
Kibana Prompt

When you see Setup Complete, wait until the containers finish starting.

Use docker compose ps or view Docker Desktop to check each containers status. Note: The etl_json container will
Containers

Once containers are fully running, then open Kibana.
https://localhost:5601

log in with the following:
Username: elastic
Password: The password you set in the popup box for Elastic Password
Project Structure

Force quitting Docker Desktop and reopening it has been found to fix a variety of problems with VerityBot.

Project Structure

About

VerityBot is a security analysis application designed for the University of Louisville Computer Science capstone class of Spring 2026. It uses a containerized ETL pipeline to collect Verkada security event data, transform it for Elasticsearch, and present insights through Kibana dashboards.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages