panopticon records usage metrics from homeservers
  • Go 40.5%
  • Python 34.9%
  • Shell 23.7%
  • Dockerfile 0.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Eric Eastwood 1bf34dc13e 0.4.0
Co-authored-by: Olivier 'reivilibre <oliverw@matrix.org>
2026-10-20 16:03:07 +01:00
.github/workflows Make Python tests robust to one of them failing 2026-10-16 18:06:20 -05:00
scripts Make sure we use the new connect_db helper for new tests 2026-10-19 11:06:17 -05:00
tests Add test for R30v2 2021-07-07 13:47:04 +01:00
.gitignore Simple CI for the aggregate script (#29) 2021-08-19 09:20:15 +01:00
CHANGELOG.md 0.4.0 2026-10-20 16:03:07 +01:00
docker-start.sh All sorts of things to make a docker build exist 2019-04-26 18:03:53 +01:00
docker-tests.sh All sorts of things to make a docker build exist 2019-04-26 18:03:53 +01:00
Dockerfile Use Debian trixie (distro that still has the package repo active) 2026-10-15 18:02:19 -05:00
Dockerfile-aggregate Align Python version in Docker image 2026-10-15 13:42:52 -05:00
Dockerfile-tests Add -y so the packages would actually install if necessary 2026-10-15 18:25:54 -05:00
go.mod Use Debian trixie (distro that still has the package repo active) 2026-10-15 18:02:19 -05:00
go.sum Add go mod 2022-05-05 13:54:26 +02:00
homeserver_dendrite.go Add table and support for Dendrite stats (#32) 2022-05-05 12:43:12 +02:00
homeserver_synapse.go Add table and support for Dendrite stats (#32) 2022-05-05 12:43:12 +02:00
LICENSE copyright & license 2018-03-16 13:38:28 +00:00
main.go Add table and support for Dendrite stats (#32) 2022-05-05 12:43:12 +02:00
README.md Use Debian trixie (distro that still has the package repo active) 2026-10-15 18:02:19 -05:00
RELEASING.md 0.4.0 2026-10-20 16:03:07 +01:00
requirements.txt Bump six for Python 3.12 compatibility 2026-10-15 13:42:36 -05:00
run-panopticon.py Simple CI for the aggregate script (#29) 2021-08-19 09:20:15 +01:00
runtests.sh Fix bash syntax error 2026-10-15 18:20:53 -05:00

panopticon

panopticon records usage metrics from homeservers

Building

Tested with Python 3.12 and Go 1.26

To build, run:

go build

Testing

There is a second Dockerfile-tests that builds panopticon to run the tests as above, as we probably want locally.

This only requires docker on your local workstation, no go install or dependencies required.

docker-tests.sh

To add new tests, crib exiting files in the tests directory.

Deployment using docker image

Set the environment variables for the go image

  • PANOPTICON_DB_DRIVER (eg, mysql or sqlite)
  • PANOPTICON_DB (go mysql connection string or filename for sqlite)
  • PANOPTICON_PORT (http port to expose panopticon on)

Set the environment variables for the python image

  • PANOPTICON_DB_NAME
  • PANOPTICON_DB_USER
  • PANOPTICON_DB_PASSWORD
  • PANOPTICON_DB_HOST
  • PANOPTICON_DB_PORT