This is the Python Software Foundation's fork of Plausible Analytics, running at analytics.python.org. It tracks traffic across PSF infrastructure sites with privacy-friendly, cookie-free analytics.

The fork adds a few things on top of upstream Plausible CE:

• A custom landing page at / with links to public dashboards
• Unix domain socket support for Cabotage deployments
• PSF-specific Procfile and Dockerfile configuration

We try to sync with upstream periodically. PSF-specific changes live on the v3.0.1-psf branch.

These are open to everyone, no login required:

• python.org
• docs.python.org
• devguide.python.org
• peps.python.org
• packaging.python.org

To add a new PSF property to analytics.python.org, open an issue on this repo or reach out to the Infrastructure team. Include:

• The domain (e.g. us.pycon.org)
• Whether the dashboard should be public or private
• Who needs admin access

The infra team will create the site, provide the tracking snippet, and configure visibility.

By default, dashboards are private (team-only). To make one publicly visible, ask the infra team to toggle the "Public" setting for that site. Once public, anyone can view the dashboard at analytics.python.org/<domain> without logging in.

The landing page at / is a static HTML file at landing/index.html. It gets baked into the Docker image and served by the Phoenix app through PageController. Logged-in users get redirected to /sites as usual.

To edit the landing page, change landing/index.html and push to v3.0.1-psf. The next image build and deploy picks it up.

Docker. It uses:

• Elixir 1.19+, Erlang/OTP 27+
• PostgreSQL 16+
• ClickHouse 24.3+
• Node.js 23+

mix deps.get mix ecto.create mix ecto.migrate mix download_country_database npm install --prefix assets npm install --prefix tracker npm run deploy --prefix tracker

make server

The app starts at http://localhost:8000.

If you only need to iterate on the landing page HTML without running the full Elixir stack:

cd landing && python3 -m http.server 3000

Open http://localhost:3000. The links won't resolve (no Plausible backend), but you can check layout and styling.

make help Show available targets make server Start the dev server (mix phx.server) make install Full setup (deps, DB, assets) make clickhouse Start ClickHouse in Docker make postgres Start PostgreSQL in Docker 

This runs on Cabotage, the PSF's PaaS. The Procfile defines two processes:

• web — the Plausible Phoenix app, binds to a unix socket via HTTPS_UDS
• release — runs database migrations on deploy

Image builds happen automatically from the v3.0.1-psf branch. To deploy, trigger a build and deploy through the Cabotage UI.

This fork tracks plausible/analytics:master as the upstream remote.

git fetch upstream git checkout v3.0.1-psf git merge upstream/master # resolve any conflicts in PSF-specific files git push

PSF-specific changes are minimal (landing page, PageController, unix socket patch, Procfile/Dockerfile) so conflicts are rare.

Plausible CE is open source under the GNU Affero General Public License Version 3. The JavaScript tracker is MIT licensed.

Copyright (c) 2018-present Plausible Insights OÜ.