In an era of rapid geopolitical shifts and information overload, understanding the true state of global conflicts is not just an advantage—it's a necessity. From verified equipment losses to real-time territorial shifts, the difference between noise and intelligence is the tool you use to analyze it.
OsintWeb is the premier Open Source Intelligence platform designed for the modern analyst. Whether you are tracking the movement of naval carrier groups, verifying the destruction of armored vehicles, or mapping the fluctuating frontlines of asymmetric warfare, OsintWeb brings every data point into a single, cohesive operational picture.
Stop wrestling with spreadsheets and disjointed maps. Start seeing the conflict as it truly is.
OsintWeb is built on a modular architecture designed to handle every aspect of modern intelligence gathering. Below is a complete catalog of the platform's capabilities:
- Source Verification System: Automatically grade the reliability of sources and cross-reference new reports against known trusted outlets.
- Geolocation Verification Tools: precise tools for matching ground-level footage with satellite imagery to confirm exact coordinates.
- Equipment Loss Tracking: Maintain a database of verified vehicle and equipment losses, categorized by type and model (Oryx-style).
- Collaborative Verification Workflow: A multi-stage approval process where community submissions are vetted by moderators before publication.
- Real-time Alert System: Set up custom notifications for specific zones or keywords to get instant updates on critical developments.
- Advanced Search & Filtering: Drill down into data with boolean search operators, filtering by date, actor, equipment type, or event category.
- Attribution & Chronolocation: tools to determine not just where, but exactly when an event occurred using shadow analysis and weather data.
- Satellite Imagery Integration: Overlay high-resolution satellite layers directly onto the operational map for context.
- Social Media Monitoring: Track and archive posts from key accounts across major platforms to preserve fleeting evidence.
- Network Analysis: Visualize relationships between actors, funders, and proxy groups to understand the hidden web of influence.
- Report Generation: One-click export of situation reports (SITREPs) into PDF or doc format for dissemination.
- API & Data Pipeline: Full REST API access allows integration with external tools and automated data ingestion.
- Crowdsourced Intelligence: Allow public users to submit tips and evidence which go into a triage queue for analysis.
- Offline Capability: Essential features remain accessible even with intermittent internet connectivity for field researchers.
- Evidence Preservation: Automatically archive web pages and media to IPFS or local storage to prevent link rot.
- Flight Tracking Integration (ADS-B): Ingest real-time flight data to correlate air movements with ground events.
- Maritime Vessel Tracking (AIS): Monitor naval positioning and shipping lanes to detect blockades or supply runs.
- Supply Chain Disruption Tracking: specific modules to analyze how conflict impacts logistics and critical infrastructure.
- Video Frame Analysis: Extract metadata and keyframes from video evidence for detailed forensic examination.
- Reverse Image Search Aggregator: Simultaneously search multiple engines to detect reused or manipulated imagery.
- Audio Analysis & Authentication: Tools to visualize spectrograms and detect editing in released audio recordings.
- Multi-Language Translation Engine: Auto-translate reports and social media posts from over 100 languages.
- OCR & Document Analysis: Extract text from scanned documents and images to make them searchable.
- Facial Recognition Assistant: Assist in identifying key figures in footage against a known database of actors.
- Vehicle Identification Database: A reference library of military vehicle silhouettes and markings to aid identification.
- Weather & Environmental Data: Overlay historical weather data to verify claims about when footage was taken.
- Data Quality & Confidence Scoring: Every data point is assigned a confidence score based on the number and quality of sources.
- Disinformation Pattern Detection: Algorithms that flag coordinated inauthentic behavior and potential propaganda campaigns.
- Cross-Platform Correlation: Link disparate pieces of evidence across different platforms to build a stronger case.
- Radio Frequency Signal Monitoring: (Experimental) Interface for logging and visualizing RF spectrum data reports.
- Dark Web Monitoring: specialized scrapers for monitoring discussions on non-indexed networks.
- Case Management Workspaces: Collaborative "digital war rooms" where teams can organize evidence for specific investigations.
- Chronological Timeline Builder: A linear view of events that helps establish causality and sequence.
- Communication Network Mapping: Visualize the flow of information and command structures between entities.
- Training & Simulation Mode: A sandbox environment for training new analysts without affecting the live database.
Intelligence is only as good as its organization. OsintWeb transforms raw reports into verifiable, structured intelligence. It doesn't just show you where something happened; it tells you who did it, what was used, and how it impacts the broader conflict.
Imagine a system that:
- Automatically connects an event to the specific military unit involved.
- Visualizes the historical progression of a frontline with a simple slider.
- Lets you attribute attacks to state actors or non-state militias with granular precision.
- Empowers your community to crowdsource verification while maintaining a rigorous audit trail.
This is not just a map. It's a living history of the conflict.
Unlock a comprehensive arsenal of analysis tools designed for depth and precision.
Dominate the visual landscape. Our advanced mapping engine allows you to draw complex control zones, color-coded by faction, to visualize territorial control instantly. Toggle between high-resolution satellite imagery and topographic maps to analyze terrain features. The dynamic legend adapts in real-time, ensuring your reports are always clear and professional. Export your operational picture as high-resolution (300 DPI) images for briefings and publications.
Access a military encyclopedia at your fingertips. The platform comes pre-loaded with over 500+ detailed equipment profiles, ranging from Gerald R. Ford-class aircraft carriers to T-90M main battle tanks and Switchblade drones. Each entry tracks critical specifications like range, armament, and dimensions. More importantly, it tracks inventory and attrition—allowing you to monitor verified losses and remaining stock for every country in a conflict.
Document the reality of war with precision. Utilize 49+ specialized event templates covering everything from airstrikes and naval engagements to cyber attacks and humanitarian crises. Every event supports rich media attachments—images, videos, and documents—creating a verifiable chain of evidence. Link specific equipment losses to events to build a forensic record of the battlefield.
Modern warfare is complex. OsintWeb creates a clear web of attribution, tracking 197 state actors alongside 28+ non-state groups including PMCs (Wagner), militias (Houthis, RSF), terrorist organizations (ISIS, Al-Qaeda), and rebel forces (SDF, Arakan Army). Our smart system understands alliances and proxies, allowing you to attribute actions correctly—whether it's a state army or a shadow group. Real-time fuzzy search ensures you never miss a connection.
History is a sequence of events. Our Timeline Analysis tools let you scrub through time, watching frontlines shift and battles unfold day-by-day. Use the Chronological Builder to construct custom investigation timelines, linking disparate events into a cohesive narrative to understand the cause and effect of military operations.
Turn analysis into influence. The built-in CMS allows you to publish deep-dive situation reports, daily briefings, and investigative articles. With support for premium content gates, SEO optimization, and rich media embedding, your analysis reaches the right audience with maximum impact.
Trust is paramount. Protect your intelligence with Role-Based Access Control (RBAC). Assign granular permissions (over 50 types) to analysts, moderators, and viewers. Every action is logged in a cryptographic Audit Trail, ensuring data integrity and accountability. The system includes full GDPR compliance tools, ensuring you meet privacy standards while managing sensitive data.
Build a community of trusted analysts. The configurable Achievement System rewards high-quality contributions with medals, titles, and ranks. Gamify the verification process to encourage engagement and recognize your most valuable contributors.
Ready to start tracking? You can deploy a fully functional demonstration environment in minutes.
See OsintWeb in action immediately with our single-command deployment. This will set up the entire stack and populate it with mock conflict data so you can explore the features right away.
(Requires Docker)
# Clone the repository
git clone https://github.com/your-org/osintweb.git
cd osintweb
# Run the demo script
./start-demo.shWhat this does:
- Builds the secure application container.
- Initializes the database and installs dependencies.
- Seeds the system with:
- 500+ military equipment items with detailed specifications
- 17 active global conflicts (Ukraine, Gaza, Syria, Yemen, etc.)
- 225+ state and non-state actors (including Wagner, Hamas, Hezbollah, SDF)
- 20+ sample events with geolocation data
- 13 control zones with territorial boundaries
- 10 sample anonymous intelligence tips
- Launches your personal intelligence platform at
http://localhost:8000.
For production environments or manual setup without Docker, follow these steps.
- Builds the application container (PHP, Composer, Node.js).
- Starts a local MySQL database.
- Installs all dependencies.
- Seeds the database with comprehensive sample data:
- 500+ military equipment items with detailed descriptions
- 17 global conflicts covering all major active war zones
- 225+ state actors (countries) and non-state armed groups
- Sample events, control zones, and anonymous tips
- Launches the platform at
http://localhost:8000.
OsintWeb provides powerful tools for:
- Interactive Mapping - Draw control zones, track territorial changes, add events with a click
- Military Equipment Database - Comprehensive catalog of ships, vehicles, aircraft, helicopters, and missile systems
- Event Documentation - 49 event types for tracking combat, equipment losses, sightings, and more
- Actor Attribution - Track perpetrators and victims (countries AND non-state groups)
- Timeline Analysis - Historical playback, date comparisons, and change tracking
- Collaborative Intelligence - Multi-source verification, community contributions, and audit trails
- Control Zones: Draw and color-code control zones with faction assignments to track territorial changes.
- Dynamic Legend: Automatically generated legend based on visible map elements.
- Export Options: Export high-quality maps as PNG, JPG, PDF, or SVG (up to 300 DPI).
- Satellite Layers: Toggle between OpenStreetMap, Satellite, and hybrid views.
- No Login Required: Browse the interactive map, events, equipment, and conflicts without authentication.
- Public Explore Pages: Dedicated pages for events, equipment, actors, and conflict zones.
- Crowdsourced Tips: Submit anonymous intelligence tips through a streamlined public form.
- Contact & About: Professional landing pages for community engagement.
- Comprehensive Catalog: 500+ pre-loaded items including ships, tanks, aircraft, helicopters, drones, artillery systems, air defense systems, support vehicles, and 50+ detailed missile systems.
- Detailed Specs: Track dimensions, armament, range, and production numbers.
- Inventory Tracking: Monitor per-country inventory levels and loss statistics.
- CRUD Operations: Full management capabilities via API and admin panel.
- 49+ Event Types: Templates for combat, sightings, infrastructure damage, and more.
- Attribution: Link events to specific perpetrators, victims, and equipment owners.
- Evidence Handling: Attach images, videos, and documents to verify events.
- Multi-Actor Support: Track state actors (197 countries) and non-state groups (militias, terrorist orgs).
- Smart Autocomplete: Priority-based sorting for active conflict parties.
- Aliases & Search: Real-time fuzzy search with support for alternate names.
- Historical Playback: Animate map changes over time to visualize conflict progression.
- Diff Views: Compare map states between any two dates.
- Chronological Builder: Construct custom investigation timelines linked to events.
- Granular Permissions: 50+ permission types for fine-grained access control.
- Admin Management UI: Full CRUD interface for Roles and Permissions management.
- Hierarchical Roles: Admin, Moderator, Analyst, and Viewer roles with inheritance.
- Team Management: Group-based permissions and time-limited access grants.
- Custom Alerts: Configure alerts for regions, keywords, event types, or specific actors.
- Real-time Notifications: Get instant updates when matching events are created.
- Alert History: Track triggered alerts with links to relevant events.
- Email & Push: Multi-channel notification delivery options.
- Customizable Templates: Full HTML and plain text templates for all platform emails (welcome, verification, password reset, alerts, weekly digest).
- Enhanced Template Editor: Professional split-pane editor with code editing and live preview side-by-side.
- Syntax Highlighting: Real-time HTML syntax highlighting with tag, attribute, value, and variable coloring.
- Variable Insertion: Searchable dropdown for inserting template variables with descriptions.
- Content Blocks: Pre-built email components (buttons, headings, images, dividers, columns, footer, social links) for rapid template creation.
- Quick Insert Toolbar: One-click insertion for common HTML elements (bold, italic, links, paragraphs, lists).
- Device Preview: Toggle between desktop, tablet, and mobile preview widths to test responsive designs.
- Undo/Redo History: Full undo/redo support with keyboard shortcuts (Ctrl+Z, Ctrl+Y) and 50-state history.
- Code Formatting: One-click HTML code formatting with proper indentation.
- 10 System Templates: Pre-built templates for welcome, email verification, password reset, account locked, new login alert, alert triggered, event verified, weekly digest, data export ready, and account deletion.
- Single-Click Unsubscribe: RFC 8058 compliant one-click unsubscribe with signed URLs for all non-essential emails.
- Email Preferences: Per-category unsubscribe options (marketing, notifications, alerts, digest) with user preference management.
- Email Logging: Track sent emails with status (pending, sent, delivered, opened, failed) and error messages.
- Statistics Dashboard: Monitor email performance with daily/weekly/monthly send counts, failure rates, and unsubscribe trends.
- Template Variables: Dynamic content insertion with 20+ common variables and template-specific variables.
- SITREP Builder: Generate situation reports with customizable templates.
- Export Formats: Download reports as PDF, DOCX, or HTML.
- Scheduled Reports: Automate daily, weekly, or monthly report generation.
- Custom Branding: Add organization logos and styling to reports.
- Publishing System: Create analysis, reports, and tutorials with rich text editing.
- Premium Content: Monetize content with subscription-based access barriers.
- SEO Optimization: Built-in support for meta tags, slugs, and social sharing.
- Threaded Comments: Deep nesting support with moderation tools.
- Anti-Spam: Advanced protection using honeypots, rate limiting, and spam scoring.
- User Profiles: Customizable profiles with unique generated avatars.
- AI Agents: Deploy agents for tasks like geolocation and image verification.
- Agent Management: Full admin UI to create, configure, and monitor AI agents.
- Smart Skills: Keyword-triggered capabilities that enhance investigation workflows.
- Skills Administration: Manage skills with triggers, configurations, and agent assignments.
- Transcription: AI-powered audio transcription with speaker identification.
- 5 Inference Providers: OpenRouter, Google Gemini, Groq, Cerebras, and Mistral AI - all with free tiers.
- OpenAI-Compatible: All providers use OpenAI-compatible endpoints for seamless switching.
- Automatic Fallback: If one provider is rate-limited or fails, automatically try the next available provider.
- Task-Specific Routing: Configure different providers for different tasks (vision, translation, etc.).
- Provider Comparison:
| Provider | Speed | Context Window | Vision | Free Tier Highlights |
|---|---|---|---|---|
| OpenRouter | Medium | Varies | Yes | Multiple free models (Llama, Mistral, Gemma) |
| Google Gemini | Fast | 1M tokens | Yes | 15 RPM, 1500 requests/day |
| Groq | Fastest | 128K | Yes | 30 RPM, 14,400 requests/day |
| Cerebras | Fastest | 128K | No | 30 RPM, 1B tokens/month |
| Mistral AI | Fast | 128K | Yes | Experimental tier, European provider |
- Use Cases:
- OCR & Vision: Gemini (1M context) or Groq (speed) for document analysis
- Translation: Mistral (multilingual) or Gemini (long documents)
- Entity Extraction: Groq or Cerebras for fastest NER processing
- Classification: Any provider with instant model switching
- Spectrogram Generation: Create detailed frequency-time visualizations using sox/ffmpeg for audio forensic analysis.
- Waveform Visualization: Generate waveform images to visualize amplitude patterns over time.
- Edit Detection: Identify potential cuts, splices, and overdubs through analysis of silence patterns, phase discontinuities, and click artifacts.
- Manipulation Scoring: Calculate authenticity scores (0-100) based on detected edits, suspicious silence patterns, and frequency anomalies.
- Voice Activity Detection: Identify regions with speech activity and calculate voice activity percentage.
- Silence Analysis: Detect silence gaps and flag suspicious patterns that may indicate content removal.
- Frequency Analysis: Analyze dominant frequencies, harmonics, and bandwidth to detect processing artifacts.
- Audio Comparison: Compare two audio files using acoustic fingerprinting to detect similarity and common sources.
- Background Processing: Queue-based analysis for long audio files with progress tracking and automatic retries.
- Analysis Types: Detect five categories of disinformation: coordinated inauthentic behavior, propaganda, fake accounts, manipulated media, and false narratives.
- Pattern Library: Comprehensive library of known disinformation tactics with linguistic, behavioral, temporal, network, and media patterns.
- Threat Scoring: Automated threat scoring (0-100) based on detected indicators with confidence metrics.
- AI-Powered Analysis: Optional integration with OpenRouter.ai free models (Llama, Gemma, Mistral) for advanced text analysis.
- Coordinated Behavior Detection: Analyze multiple posts for synchronized posting, content similarity, hashtag coordination, and network anomalies.
- Propaganda Indicators: Detect loaded language, fear appeals, bandwagon effects, black-and-white thinking, and whataboutism patterns.
- Temporal Analysis: Identify unusual posting times, burst activity, and bot-like regular intervals.
- Source Credibility: Check sources against known reliable/unreliable domain lists with typosquatting detection.
- Content Flagging: Flag suspicious content with priority levels (low to critical) and detailed audit trail.
- Review Workflow: Multi-stage review process with pending, confirmed, rejected, and needs-review statuses.
- Appeal System: Allow appeals on flagged content with dedicated review workflow.
- Statistics & Trends: Dashboard with threat trends, pattern match statistics, and common indicator analysis.
- Configurable Thresholds: Customize auto-flag thresholds, threat weights, and moderation settings.
- Historical Weather Lookup: Fetch weather conditions for any location and time via OpenWeatherMap or Visual Crossing APIs.
- Sun Position Calculator: Precise astronomical calculations for sun azimuth and elevation at any coordinates and datetime.
- Shadow Verification: Verify if shadow angles in images match expected sun position for claimed time and location.
- Chronolocation Analysis: Find possible times when a photo was taken based on shadow direction and length.
- Event Weather Linking: Automatically or manually link weather data to events for verification context.
- Shadow Analysis Reports: Detailed analysis including confidence scoring, deviation calculations, and verification notes.
- Multi-Provider Support: Configurable weather data providers with automatic caching to reduce API calls.
- OSINT Integration: Weather conditions and sun position data support for verifying the authenticity of imagery.
- Vessel Database: Track vessels by MMSI, IMO number, name, and callsign with comprehensive specifications including dimensions, tonnage, and build year.
- Vessel Classification: Categorize vessels by type (cargo, tanker, passenger, fishing, military, tug, yacht) with priority-based monitoring (1-5 levels).
- AIS Position Tracking: Record vessel positions with speed, course, heading, navigation status, destination, and ETA from multiple data sources.
- Multi-Provider Support: Integrate with MarineTraffic, VesselFinder, MyShipTracking, FleetMon, or direct AIS receiver feeds.
- Track Building: Automatically build voyage tracks from position data with distance calculations and average speed metrics.
- Port Call History: Track vessel arrivals and departures at ports with duration, call type (loading, unloading, bunkering, repair), and voyage context.
- Dark Activity Detection: Identify AIS gaps that may indicate intentional signal concealment with configurable thresholds by vessel type.
- STS Transfer Detection: Detect potential ship-to-ship transfers based on proximity patterns and speed anomalies between vessels.
- Geofencing Alerts: Create zone-based alerts for strategic chokepoints (Strait of Hormuz, Suez Canal, Panama Canal) with custom polygon definitions.
- Alert Types: Monitor for vessel spotted, zone entry/exit, port calls, dark activity, STS transfers, speed anomalies, and route deviations.
- Live Tracking: Real-time vessel positions with geographic filtering, vessel type filters, and bounding box queries.
- Event Correlation: Link vessel tracks to OSINT events for comprehensive maritime intelligence analysis.
- Background Fetching: Scheduled position updates with priority-based fetch intervals (high: 5min, medium: 15min, low: 60min).
- Spatial Queries: MySQL spatial extensions for efficient zone containment and proximity searches.
- Achievement Management: Full admin CRUD for creating and managing achievements.
- Categories & Rarity: Organize achievements by contribution, verification, engagement types.
- Point System: Configurable point values and rarity tiers (common to legendary).
- User Rewards: Track and display user achievements on profiles.
- Global Conflicts Database: 17+ pre-loaded active conflicts with detailed metadata.
- Actor Attribution: 225+ state and non-state actors (militias, PMCs, insurgent groups).
- Control Zones: Track territorial control with conflict-linked zones.
- Event Correlation: Link events to specific conflicts for comprehensive analysis.
- Anonymous Tip Submission: Public API for submitting intelligence tips without authentication.
- Moderation Workflow: Review, verify, and escalate tips through status stages.
- Tip Types: Military movement, infrastructure damage, air/naval activity, war crimes, disinformation.
- Conversion to Events: Transform verified tips into official events with one click.
- GDPR Compliance: Built-in tools for consent management, data export, and "right to be forgotten".
- Password Reset: Secure password recovery with time-limited tokens (60 minutes), hashed token storage, and automatic session revocation on reset.
- Immutable Audit Trail: Cryptographic hash-chain logging of all admin and user actions with tamper detection and chain integrity verification.
- Admin Action Logging: Automatic middleware-based logging of all admin panel operations with IP tracking and user agent capture.
- Session Management: Track and terminate active user sessions.
- Permission-Based Audit Access: Separate
audit.viewandaudit.exportpermissions control who can access the audit trail.
- Public Activity Feed: Real-time feed of community contributions for the homepage showing events created, sources verified, and evidence submitted.
- Activity Statistics: Dashboard showing contribution counts, active contributors, and verification metrics.
- User Activity Logging: Track page views, searches, map interactions, and content views for engagement analytics.
- Activity Types: 40+ activity types covering page views, content interactions, contributions, and social actions.
- Batch Activity Logging: Efficient client-side queuing with automatic batch submission to reduce API calls.
- Anonymous Aggregated Data: Privacy-respecting analytics that track usage patterns without storing personal information.
- Page View Analytics: Track total and unique page views with hourly aggregation buckets and daily trends.
- Feature Usage Tracking: Monitor which features are actually used across 8 categories (navigation, content, tools, export, map, filter, search, media).
- Session Analytics: Daily session aggregates including bounce rate, average duration, pages per session, and device breakdown.
- Search Analytics: Track search terms, result counts, and zero-result searches to improve content discoverability.
- User Flow Analysis: Visualize navigation paths showing how users move through the platform with entry/exit page tracking.
- Device Statistics: Breakdown of desktop, mobile, and tablet usage for responsive design optimization.
- Admin Dashboard: Comprehensive analytics dashboard with charts, top pages, popular features, and export functionality.
- GDPR Compliant: Respects Do Not Track browser settings and uses cookie-based anonymous visitor hashing.
- Experiment Management: Create, manage, and analyze A/B tests for text, buttons, layouts, and features.
- Statistical Significance Testing: Z-score calculations with confidence intervals (95% threshold) to determine winning variants.
- Cookie-Based Anonymous Assignment: Consistent variant assignment without storing personal data using SHA-256 visitor hashing.
- Multiple Experiment Types: Support for text variations, button variants, layout changes, and feature toggles.
- Conversion Tracking: Track clicks, signups, engagement, scroll depth, time on page, form submissions, and custom goals.
- Traffic Allocation: Configure what percentage of visitors participate in each experiment (1-100%).
- Variant Weighting: Assign custom weights to control and variant groups for unequal traffic splits.
- Results Dashboard: View impressions, conversions, conversion rates, improvement percentages, and confidence levels.
- Winner Detection: Automatic winner determination when statistical significance is reached.
- Experiment Lifecycle: Draft, running, paused, and completed states with start/pause/complete controls.
- Vue Composables: Frontend composables (
useABTest,useABTests,useABContent) for easy variant rendering. - Public API: Endpoints for getting variants and tracking conversions from any frontend.
- NATO Admiralty System: Grade sources using the A-F reliability and 1-6 credibility scale.
- Trusted Sources Database: Maintain a list of verified and trusted intelligence sources.
- Cross-Reference Tool: Check claims against multiple independent sources.
- Source Type Classification: Categorize sources as official, journalistic, social media, satellite, etc.
- Verification Projects: Create collaborative geolocation investigations.
- Sun Position Calculator: Determine exact time of footage using shadow analysis.
- Reverse Geocoding: Convert coordinates to human-readable locations.
- Weather Data Integration: Verify claims using historical weather conditions.
- Satellite Layer Access: Multiple imagery providers for comparison.
- Installation Wizard: Web-based setup for database, admin user, and basic settings.
- Docker Ready: Compatible with containerized environments.
- Customizable: Configure branding, map defaults, and system preferences easily.
- Backend: Laravel 11+ (PHP 8.2+)
- Frontend: Vue.js 3 + TypeScript
- Database: MySQL 8.0+ with spatial extensions
- Maps: Leaflet.js with OpenStreetMap
- Cache: Laravel file/database cache (no Redis)
- Search: Meilisearch or MySQL full-text
- Hosting: Shared hosting compatible ($5-15/month)
OsintWeb provides a comprehensive REST API with 80+ endpoints covering all platform features.
| Endpoint | Description |
|---|---|
POST /api/auth/forgot-password |
Request password reset email |
POST /api/auth/reset-password |
Reset password with token |
POST /api/tips/submit |
Submit anonymous intelligence tip |
GET /api/tips/types |
Get available tip categories |
GET /api/tips/status/{uuid} |
Check tip status |
GET /api/public/conflicts |
List all conflicts |
GET /api/public/conflicts/active |
Get active conflicts |
GET /api/public/conflicts/{slug} |
Get conflict details |
GET /api/activity/feed |
Get public activity feed for homepage |
GET /api/activity/stats |
Get activity statistics |
GET /api/activity/types |
Get available activity types |
GET /api/health |
Service health check |
| Category | Base Path | Key Operations |
|---|---|---|
| Events | /api/events |
CRUD, verify, dispute, media, sources |
| Equipment | /api/equipment |
CRUD, categories, stats, by-country |
| Zones | /api/zones |
CRUD, history, at-date snapshots |
| Countries | /api/countries |
List, equipment, factions |
| Actors | /api/actors |
Search, autocomplete, details |
| Conflicts | /api/conflicts |
List, events, zones, statistics, actors |
| Category | Base Path | Key Operations |
|---|---|---|
| Alerts | /api/alerts |
CRUD, history, test notifications |
| Reports | /api/reports |
Templates, generate, download, schedule |
| Timeline | /api/timeline |
Compare, territorial, playback, milestones |
| Sources | /api/sources |
Grade, cross-reference, trusted list |
| Geolocation | /api/geolocation |
Projects, sun-position, reverse-geocode |
| Tips | /api/tips |
Moderation workflow, convert to events |
| Activity | /api/activity |
Log activities, batch logging, user history |
| Category | Base Path | Key Operations |
|---|---|---|
| Audit Logs | /api/admin/audit-logs |
List, stats, filter, verify chain, export, clear old |
| Achievements | /api/admin/achievements |
CRUD operations for achievement system |
| Site Analytics | /api/admin/analytics |
Dashboard, page views, features, sessions, flows, search, export |
| A/B Testing | /api/admin/experiments |
CRUD, start/pause/complete, results, variants, daily stats |
| Endpoint | Description |
|---|---|
GET /api/ab/variant/{location} |
Get variant for a location |
POST /api/ab/variants |
Get variants for multiple locations |
POST /api/ab/conversion/{slug} |
Track conversion for experiment |
POST /api/ab/conversion-location/{location} |
Track conversion by location |
| Endpoint | Description |
|---|---|
POST /api/track/feature |
Track feature usage event |
POST /api/track/search |
Track search event |
POST /api/track/batch |
Track multiple events in batch |
| Category | Base Path | Key Operations |
|---|---|---|
| Audio | /api/audio |
Upload, transcriptions (manual/AI), export |
| Skills | /api/skills |
Match, trigger, preferences |
| Agents | /api/agents |
Create, run, executions |
| Category | Base Path | Key Operations |
|---|---|---|
| Email Templates | /api/admin/email-templates |
CRUD, preview, test, duplicate, stats, logs |
| Achievements | /api/admin/achievements |
CRUD for achievement management |
| Category | Base Path | Key Operations |
|---|---|---|
| Email Preferences | /api/email-preferences |
Get/update preferences, resubscribe |
- Complete Feature Specification - Detailed development guide
- Development Guidelines - Code standards and conventions
- Actor Attribution System - Country/group tracking for events
- Conflict Party Autocomplete - Smart actor selection with active conflicts
- Audit Trail Specification - Complete change tracking system
- Additional OSINT Features - 20 new intelligence features
- MySQL Stack Specification - Database architecture and hosting guide
- Stack Migration Summary - Quick reference for tech stack
- Audit Implementation Guide - Audit trail quick start
- Installation Wizard Specification - One-time setup wizard
- Actor Attribution Quick Reference - Developer cheat sheet
This section covers detailed installation for production or development environments without Docker.
Minimum Requirements:
- PHP 8.2+ with extensions: mysql, mbstring, xml, curl, zip, bcmath, gd
- MySQL 8.0+ with spatial support
- Node.js 18+ and npm
- Composer 2.0+
Optional (for advanced features):
- Meilisearch (for better search, can use MySQL full-text instead)
- Supervisor (for queue workers on VPS)
The easiest way to install OsintWeb is through the interactive web-based wizard:
# Clone repository
git clone https://github.com/your-org/osintweb.git
cd osintweb
# Install dependencies
composer install
npm install && npm run build
# Copy environment file
cp .env.example .env
# Start development server
php artisan serveThen visit http://localhost:8000. The installation wizard will guide you through database configuration, admin account creation, and system settings.
# Clone and install
git clone https://github.com/your-org/osintweb.git
cd osintweb
composer install
npm install
# Configure environment
cp .env.example .env
php artisan key:generate
# Configure database in .env:
# DB_CONNECTION=mysql
# DB_HOST=127.0.0.1
# ...
# Create database & Run migrations
php artisan migrate --seed
# Build frontend
npm run build
# Start server
php artisan serveFor shared hosting environments without SSH/CLI access, follow these steps:
Step 1: Prepare locally
On your local machine (requires PHP 8.2+, Composer, Node.js):
# Clone the repository
git clone https://github.com/your-org/osintweb.git
cd osintweb
# Install PHP dependencies
composer install --optimize-autoloader --no-dev
# Install and build frontend
npm install
npm run build
# Generate application key
cp .env.example .env
php artisan key:generateStep 2: Configure .env
Edit the .env file with your shared hosting database credentials:
APP_NAME=OsintWeb
APP_ENV=production
APP_DEBUG=false
APP_URL=https://yourdomain.com
DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_user
DB_PASSWORD=your_database_password
SESSION_DRIVER=database
CACHE_STORE=database
QUEUE_CONNECTION=databaseStep 3: Upload files
Upload the entire project folder to your hosting account via FTP/SFTP.
Step 4: Configure document root
Point your domain's document root to the public/ folder:
| Hosting Panel | Setting Location |
|---|---|
| cPanel | Domains > Modify > Document Root |
| Plesk | Domains > Hosting Settings > Document Root |
| DirectAdmin | Domain Setup > Document Root |
Set it to: /home/username/osintweb/public (adjust path as needed)
Alternative: Use .htaccess redirect
If you cannot change the document root, add this to your root .htaccess:
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^(.*)$ public/$1 [L]
</IfModule>Step 5: Set permissions
Via your hosting file manager, set these folder permissions to 755 or 775:
storage/bootstrap/cache/
Step 6: Run the installer
Visit your domain in a browser. The installation wizard will:
- Check system requirements
- Configure database connection
- Run migrations automatically
- Create your admin account
- Configure basic settings
Troubleshooting Shared Hosting:
| Issue | Solution |
|---|---|
| 500 Error | Check storage/logs/laravel.log for details |
| Blank page | Enable APP_DEBUG=true temporarily in .env |
| Session errors | Ensure storage/framework/sessions is writable |
| CSS/JS not loading | Verify document root points to public/ |
OsintWeb is built for the community. Join us in bringing transparency to global conflicts.