GOSI workstation

GOSI-Ready OSINT VM

Turn a clean Ubuntu virtual machine into a structured OSINT workstation with one installer.

The setup uses official Ubuntu repositories only. Case folders, evidence templates, reporting structure, and verification commands are included.

Ready in three steps

  1. 01Create the VMInstall Ubuntu Desktop 24.04 LTS. Four CPU cores, 8 GB RAM, a 60 GB disk, and NAT networking are enough.
  2. 02Run the installerExtract a release bundle or clone the repository. Run install.sh as your normal user.
  3. 03Check the setupOpen a new terminal, run gosi-check, and create your first case folder.

Install from the repository

Run these commands in the Ubuntu VM terminal. Do not start the installer with sudo.

git clone https://github.com/0xCD4/gosi-ready-osint-vm.git
cd gosi-ready-osint-vm
chmod +x install.sh setup.sh scripts/*.sh
./install.sh --full

Which profile should I use?

Full installation

Recommended for new users. It also installs screenshot, document, image, database, and password vault applications.

./install.sh --full

Minimal installation

A lighter profile with command-line, DNS, metadata, OCR, PDF, and Python tools.

./install.sh --minimal

Three commands after installation

gosi-check
gosi-new-case "First practice case"
gosi-check
Checks installed tools and the Python environment.
gosi-new-case "Case name"
Creates evidence, notes, reports, and export folders.
gosi-clean
Shows temporary areas to clean at the end of a session and asks for confirmation.

Clear usage boundary

This workstation is for lawful, passive, public-source research. It does not install unauthorized-access, brute-force, doxxing, leaked-data, or offensive tooling. gosi-clean does not provide anonymity and is not a forensic wipe.

English quick start