Install MistSeeker
A Docker-based, fully on-premise code stability analysis engine
On-Premise & Secure
MistSeeker ensures maximum portability across all environments and complete protection of your source code.
All analysis is executed locally on your machine—no code, metadata, or results are ever transmitted externally.
Requirements
Docker Installed
MistSeeker requires Docker to run.
macOS / Windows
Docker Desktop
Linux / Servers
Docker Engine
Verify installation:
Pull the Docker Image
This downloads the latest official MistSeeker image.
Quick Start (Free Mode)
Free Mode provides COI/ORI/GSS/GSI scores, project/file-level summaries, and basic PNG reports. It shows problem existence, total issue count, and stability scores.
macOS / Linux:
docker run -it --rm \
-v "$(pwd)":/app/code \
-v "$(pwd)":/app/out \
tongro2025/mistseeker:latest \
analyze --input-root /app/code \
--output-json /app/out/mistseeker_report.json \
--output-image /app/out/mistseeker_report.pngWindows (PowerShell):
docker run -it --rm \
-v "${PWD}:/app/code" \
-v "${PWD}:/app/out" \
tongro2025/mistseeker:latest \
analyze --input-root /app/code \
--output-json /app/out/mistseeker_report.json \
--output-image /app/out/mistseeker_report.pngWindows (CMD):
docker run -it --rm ^
-v "%CD%:/app/code" ^
-v "%CD%:/app/out" ^
tongro2025/mistseeker:latest ^
analyze --input-root /app/code ^
--output-json /app/out/mistseeker_report.json ^
--output-image /app/out/mistseeker_report.pngFree Mode Features
- •COI/ORI/GSS/GSI scores and grades
- •Project/file-level summaries
- •Basic PNG reports
- •Limited issue visibility (problem existence, total issue count, stability scores)
Pro Mode (License Required)
Pro Mode provides full COI/ORI/GSS stability metrics, line-level issues and detailed locations (file/function/line), segment analysis, Pro-only PNG sections with top risk files/functions, major issue summaries, and rich stability summaries for CI/CD review.
Note: The pro keyword is optional. When MISTSEEKER_LICENSE_KEY environment variable is provided, MistSeeker automatically runs in Pro mode.
macOS / Linux:
docker run -it --rm \
-e MISTSEEKER_LICENSE_KEY=YOUR_LICENSE_KEY \
-v "$(pwd)":/app/code \
-v "$(pwd)/reports":/app/out \
tongro2025/mistseeker:latest \
analyze --input-root /app/code \
--output-json /app/out/mistseeker_report.json \
--output-image /app/out/mistseeker_report.pngWindows (PowerShell):
docker run -it --rm \
-e MISTSEEKER_LICENSE_KEY=YOUR_LICENSE_KEY \
-v "${PWD}:/app/code" \
-v "${PWD}/reports:/app/out" \
tongro2025/mistseeker:latest \
analyze --input-root /app/code \
--output-json /app/out/mistseeker_report.json \
--output-image /app/out/mistseeker_report.pngWindows (CMD):
docker run -it --rm ^
-e MISTSEEKER_LICENSE_KEY=YOUR_LICENSE_KEY ^
-v "%CD%:/app/code" ^
-v "%CD%/reports:/app/out" ^
tongro2025/mistseeker:latest ^
analyze --input-root /app/code ^
--output-json /app/out/mistseeker_report.json ^
--output-image /app/out/mistseeker_report.pngReplace YOUR_LICENSE_KEY with the license key provided by Paddle after purchase.
Saving Analysis Reports
Export the results to your local directory:
macOS / Linux:
docker run -it --rm \
-e MISTSEEKER_LICENSE_KEY=YOUR_LICENSE_KEY \
-v "$(pwd)":/app/code \
-v "$(pwd)/reports":/app/out \
tongro2025/mistseeker:latest \
analyze --input-root /app/code \
--output-json /app/out/mistseeker_report.json \
--output-image /app/out/mistseeker_report.pngWindows (PowerShell):
docker run -it --rm \
-e MISTSEEKER_LICENSE_KEY=YOUR_LICENSE_KEY \
-v "${PWD}:/app/code" \
-v "${PWD}/reports:/app/out" \
tongro2025/mistseeker:latest \
analyze --input-root /app/code \
--output-json /app/out/mistseeker_report.json \
--output-image /app/out/mistseeker_report.pngWindows (CMD):
docker run -it --rm ^
-e MISTSEEKER_LICENSE_KEY=YOUR_LICENSE_KEY ^
-v "%CD%:/app/code" ^
-v "%CD%/reports:/app/out" ^
tongro2025/mistseeker:latest ^
analyze --input-root /app/code ^
--output-json /app/out/mistseeker_report.json ^
--output-image /app/out/mistseeker_report.png⚠️ Important:
Always specify --output-json and --output-image paths that point to a mounted volume (e.g., /app/out/) to ensure files are saved to your local machine. Without explicit output paths, files will be saved inside the container and lost when it exits.
Output files include:
mistseeker_report.json
mistseeker_report.png
Supported Environments
MistSeeker runs identically across:
macOS (Apple Silicon / Intel)
Windows (PowerShell / CMD)
Linux (Ubuntu, CentOS, etc.)
On-premise servers
Private clusters / CI pipelines
GPU servers (GPU not required)
Docker ensures full compatibility across all platforms.
Security & Privacy
MistSeeker is designed for maximum security:
0% source code collection
0% data transmission
0 telemetry or usage analytics
0 embeddings or intermediate data uploads
100% local execution
All payment processing is handled by Paddle (Merchant of Record).
Convia only receives your email address for license activation and support.
Refer to our Privacy Policy for full details.
Frequently Asked Questions
Q1. Are there installation methods other than Docker?
No, MistSeeker only supports Docker installation. Docker ensures consistent behavior across all platforms and environments without requiring additional configuration.
Simply pull the Docker image and run it—no local dependencies or setup required.
Q2. What's the difference between Free and Pro?
| Feature | Free | Pro |
|---|---|---|
| Stability check | Yes/No | Full metrics |
| COI / ORI / GSS | — | Detailed scores |
| Issue locations | — | File / function / line |
| Reports | — | HTML / JSON |
| Usage | Unlimited | Unlimited |
Q3. My Pro license key isn't working.
Most common causes:
- Typo in the key
- Subscription expired
- Wrong environment variable name
Correct format:
Q4. Container cannot access my files.
Check your volume mount path. Use the correct syntax for your platform:
macOS / Linux:
Windows PowerShell:
Windows CMD: