Ackee Analytics

Key Features

• Cookie-free tracking with automatic visitor anonymization and IP address hashing
• Real-time analytics dashboard showing live visitor counts and page views
• Detailed referrer tracking including social media, search engines, and direct traffic sources
• Device and browser statistics without fingerprinting or personal identification
• Multi-domain support allowing analytics for multiple websites from single dashboard
• MongoDB aggregation pipeline integration for complex analytics queries and custom reports
• Lightweight JavaScript tracking script with minimal impact on website performance
• REST API access for programmatic data retrieval and custom integrations

Common Use Cases

• 1Privacy-focused websites requiring GDPR compliance without cookie consent banners
• 2Small business websites needing basic traffic analytics without Google Analytics dependency
• 3Personal blogs and portfolios tracking visitor engagement and popular content
• 4Educational institutions monitoring website usage while protecting student privacy
• 5Non-profit organizations analyzing web traffic without compromising donor privacy
• 6Development agencies offering privacy-compliant analytics to privacy-conscious clients
• 7Corporate intranets tracking internal resource usage without employee monitoring concerns

Prerequisites

• Docker and Docker Compose installed on host system
• Minimum 1GB RAM available (512MB for MongoDB, 256MB for Ackee, plus system overhead)
• Port 3000 available for Ackee web interface access
• Environment variables ACKEE_USERNAME and ACKEE_PASSWORD configured for authentication
• Basic understanding of web analytics concepts and JavaScript integration
• Website access for embedding Ackee tracking script in HTML pages

docker-compose.yml

1services: 
2  ackee: 
3    image: electerious/ackee:latest
4    container_name: ackee
5    environment: 
6      - ACKEE_MONGODB=mongodb://mongodb:27017/ackee
7      - ACKEE_USERNAME=${ACKEE_USERNAME}
8      - ACKEE_PASSWORD=${ACKEE_PASSWORD}
9    ports: 
10      - "3000:3000"
11    depends_on: 
12      - mongodb
13    networks: 
14      - ackee-network
15    restart: unless-stopped
16
17  mongodb: 
18    image: mongo:6
19    container_name: ackee-mongodb
20    volumes: 
21      - mongo-data:/data/db
22    networks: 
23      - ackee-network
24    restart: unless-stopped
25
26volumes: 
27  mongo-data: 
28
29networks: 
30  ackee-network: 
31    driver: bridge

.env Template

1# Ackee Analytics
2ACKEE_USERNAME=admin
3ACKEE_PASSWORD=secure_ackee_password

Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

ackee:
  image: electerious/ackee:latest
  container_name: ackee
  environment:
    - ACKEE_MONGODB=mongodb://mongodb:27017/ackee
    - ACKEE_USERNAME=${ACKEE_USERNAME}
    - ACKEE_PASSWORD=${ACKEE_PASSWORD}
  ports:
    - "3000:3000"
  depends_on:
    - mongodb
  networks:
    - ackee-network
  restart: unless-stopped

mongodb:
  image: mongo:6
  container_name: ackee-mongodb
  volumes:
    - mongo-data:/data/db
  networks:
    - ackee-network
  restart: unless-stopped

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  ackee:
5    image: electerious/ackee:latest
6    container_name: ackee
7    environment:
8      - ACKEE_MONGODB=mongodb://mongodb:27017/ackee
9      - ACKEE_USERNAME=${ACKEE_USERNAME}
10      - ACKEE_PASSWORD=${ACKEE_PASSWORD}
11    ports:
12      - "3000:3000"
13    depends_on:
14      - mongodb
15    networks:
16      - ackee-network
17    restart: unless-stopped
18
19  mongodb:
20    image: mongo:6
21    container_name: ackee-mongodb
22    volumes:
23      - mongo-data:/data/db
24    networks:
25      - ackee-network
26    restart: unless-stopped
27
28volumes:
29  mongo-data:
30
31networks:
32  ackee-network:
33    driver: bridge
34EOF
35
36# 2. Create the .env file
37cat > .env << 'EOF'
38# Ackee Analytics
39ACKEE_USERNAME=admin
40ACKEE_PASSWORD=secure_ackee_password
41EOF
42
43# 3. Start the services
44docker compose up -d
45
46# 4. View logs
47docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/ackee-analytics/run | bash

Troubleshooting