cattyinstall/app

CattyInstall

Self-hosted app install attribution platform. Track installs from landing pages to mobile apps using device fingerprinting — no invite codes needed.

Quick Start

Docker Compose (Recommended)

Create a docker-compose.yml:

yaml
services:
  app:
    image: cattyinstall/app:latest
    restart: unless-stopped
    ports:
      - "80:80"
    environment:
      DATABASE_URL: "postgres://cattyinstall:yourpassword@postgres:5432/cattyinstall?sslmode=disable"
      REDIS_URL: "redis://redis:6379"
      JWT_SECRET: "change-this-to-a-random-string"  # openssl rand -hex 32
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy

  postgres:
    image: postgres:15-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: "cattyinstall"
      POSTGRES_PASSWORD: "yourpassword"  # Must match DATABASE_URL
      POSTGRES_DB: "cattyinstall"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U cattyinstall"]
      interval: 10s
      timeout: 5s
      retries: 5

  redis:
    image: redis:7-alpine
    restart: unless-stopped
    command: redis-server --appendonly yes --maxmemory 256mb --maxmemory-policy allkeys-lru
    volumes:
      - redis-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  postgres-data:
  redis-data:

Then run:

bash
docker compose up -d

Open http://your-server-ip in your browser.

Docker Run

If you already have PostgreSQL and Redis:

bash
docker run -d \
  -p 80:80 \
  -e DATABASE_URL="postgres://user:pass@your-pg:5432/cattyinstall?sslmode=disable" \
  -e REDIS_URL="redis://your-redis:6379" \
  -e JWT_SECRET="$(openssl rand -hex 32)" \
  cattyinstall/app:latest

Environment Variables

Required

Optional

What's Inside

All-in-one image containing:

• Go API Server — Attribution matching engine, analytics, dashboard API
• React Dashboard — App management, channel management, multi-dimensional analytics, retention analysis
• Nginx — Reverse proxy, static file serving, gzip compression

Database migrations run automatically on every startup. No manual steps needed when updating.

Architecture

                ┌──────────────────────────────────┐
                │      cattyinstall/app:latest      │
   :80          │                                   │
───────────────►│  Nginx ──► React Dashboard        │
                │    │                               │
                │    └──► Go API Server (:3000)      │
                │              │         │           │
                └──────────────┼─────────┼───────────┘
                               │         │
                          PostgreSQL   Redis

Updating

bash
docker compose pull
docker compose up -d

Data is persisted in PostgreSQL volumes. New migrations run automatically on startup.

HTTPS Setup

Add a reverse proxy in front of the container:

nginx
server {
    listen 443 ssl;
    server_name attribution.example.com;

    ssl_certificate     /etc/ssl/certs/your-cert.pem;
    ssl_certificate_key /etc/ssl/private/your-key.pem;

    location / {
        proxy_pass http://localhost:80;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

COOKIE_SECURE defaults to true, which is correct for HTTPS. Set it to false only for HTTP-only deployments.

Requirements