Installation Guide

<!-- Privacy-friendly analytics by Plausible -->
<script async src="https://plausible.io/js/YOUR-SCRIPT-ID.js"></script>
<script>
  window.plausible=window.plausible||function(){(plausible.q=plausible.q||[]).push(arguments)},plausible.init=plausible.init||function(i){plausible.o=i||};
  plausible.init()
</script>

npm install @plausible-analytics/tracker

import { init } from '@plausible-analytics/tracker'

init({ domain: 'example.com' })

git clone https://github.com/plausible/community-edition.git
cd community-edition

cp plausible-conf.env.example plausible-conf.env

# Your domain where Plausible will be hosted
BASE_URL=https://analytics.yourdomain.com

# Generate a random secret key
SECRET_KEY_BASE=your-secret-key-here

# Database configuration (defaults are usually fine)
# POSTGRES_PASSWORD=postgres
# CLICKHOUSE_PASSWORD=clickhouse

docker compose up -d

server {
    listen 443 ssl http2;
    server_name analytics.yourdomain.com;
    
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    
    location / {
        proxy_pass http://localhost:8000;
        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;
    }
}

<script async src="https://analytics.yourdomain.com/js/script.js"></script>
<script>
  window.plausible=window.plausible||function(){(plausible.q=plausible.q||[]).push(arguments)},plausible.init=plausible.init||function(i){plausible.o=i||};
  plausible.init()
</script>

init({
  domain: 'mywebsite.com',
  endpoint: 'https://analytics.yourdomain.com/api/event'
})

# Backup PostgreSQL
docker compose exec postgres pg_dump -U postgres plausible_db > backup.sql

# Backup ClickHouse (optional - can be regenerated)
docker compose exec clickhouse clickhouse-client --query "BACKUP DATABASE plausible_events_db"

git pull origin master

docker compose down
docker compose up -d --build

docker compose logs -f plausible