Installation
Prerequisites
- Go 1.25 or later
- Mullvad VPN -- An active Mullvad subscription and connected VPN client. odirscan verifies the connection at startup via
am.i.mullvad.netand exits if Mullvad is not active.
Building from Source
Clone the repository and build:
git clone ssh://git@git.redn3t.com:2222/Redn3t/odirscan.git
cd odirscan
go build -o odirscan .
This produces a single odirscan binary in the current directory.
Runtime Files
odirscan creates several cache files in the working directory during operation:
| File | Purpose |
|---|---|
relays.json | Cached Mullvad relay list |
relays.meta.json | ETag and Last-Modified metadata for the relay list |
findings.json | Cached scan results (reused on restart) |
These files are listed in .gitignore and safe to delete at any time.