A lightweight, privacy-focused analytics engine built for modern web applications.
Website Link 1 • Website Link 2 • GitHub Repository • API Reference
Okunix is a powerful, self-hostable web analytics platform designed to track, aggregate, and visualize key telemetry metrics in real-time. Built with a focus on simplicity and performance, Okunix provides developers with immediate insights into their application traffic without compromising end-user privacy.
- Live Viewers: Real-time websocket tracking of concurrent active sessions.
- Traffic Analytics: Accurate aggregation of Unique Visitors and Total Visits.
- Engagement Tracking: Automated Bounce Rate calculation and Session Duration tracking.
- Geographic Distribution: Interactive world mapping and detailed tabular breakdown by Country, Region, and City.
- Traffic Heatmaps: visual matrix representations of activity intensity sorted by day and operational hours (24h).
- Environment Profiling: Device, Operating System, and Browser telemetry extraction.
- Referrer Attribution: Track incoming traffic channels (Social Media, Direct, Organic Search).
- Path Analysis: Monitor specific route performance, visualizing standard pageviews alongside Entry and Exit nodes.
Okunix is built on the MERN stack, delivering high-performance telemetry processing via Node.js streams and efficient aggregation pipelines via MongoDB.
- Frontend: React.js, TailwindCSS, Chart.js, Lucide Icons
- Backend: Node.js, Express.js (See API Reference)
- Database: MongoDB & Mongoose ORM
- Authentication: JWT-based stateless authentication
Ensure the following runtimes and services are available on your host machine:
- Node.js (v18.0.0 or higher)
- MongoDB (v6.0 or higher)
- npm or yarn package manager
-
Clone the repository
git clone https://github.com/SAYOUNCDR/okunix.git cd okunix -
Install Backend Dependencies
cd server npm install -
Install Frontend Dependencies
cd ../client npm install -
Environment Configuration
Create a .env file in the server directory by copying the .env.example file.
cd server cp .env.example .envCreate a .env file in the client directory by copying the .env.example file.
cd client cp .env.example .env -
Initialize the Application
# Terminal 1: Start the Backend API cd server npm run dev # Terminal 2: Start the React Client cd client npm run dev
To begin tracking analytics on a target website, embed the Okunix tracking script into the <head> of your application. The script acts as an asynchronous unblocking beacon.
<script
defer
src="https://okunix.tech/api/tracker/script.js"
data-website-id="YOUR_WEBSITE_ID"
></script>We welcome contributions to the Okunix engine. Please read through our open issues or submit a detailed Pull Request outlining your proposed architectural changes.
This project is generously open-sourced and available under the MIT License.