Documenso

Telemetry

Learn about the telemetry data that Documenso collects from self-hosted instances.

Overview

Documenso collects anonymous telemetry data from self-hosted instances to help us understand how the software is being used and make improvements to the product. This telemetry is enabled by default, but you can easily disable it if you prefer.

What We Collect

We collect minimal, privacy-preserving information that helps us understand the health and adoption of self-hosted installations:

  • App Version: The version of Documenso you are running. This helps us understand which versions are in use and prioritize support for older versions.

  • Installation ID: A unique identifier for your installation. This is stored in your database and helps us count distinct installations without knowing who you are.

  • Node ID: A unique identifier for each server or container instance. This is stored in your operating system's temporary directory and helps us understand deployment patterns (for example, how many instances are running in a cluster).

What We Don't Collect

We do not collect any of the following:

  • Personal information about you or your users
  • Document contents or file names
  • User email addresses or names
  • Usage patterns or feature usage statistics
  • Server logs or error messages
  • Any data that could identify your organisation or users

Why We Collect Telemetry

The telemetry data we collect serves several important purposes:

All of this is done anonymously and in aggregate. We cannot identify you, your organisation, or your users from the telemetry data we collect.

Events We Track

We track two simple events:

Captured once when your server starts. This tells us when installations are first set up or restarted.

Captured every hour while your server is running. This helps us understand how many active installations exist and their uptime patterns.

How to Disable Telemetry

If you prefer not to send telemetry data, you can disable it by setting an environment variable.

Using Environment Variables

Add the following to your environment configuration:

DOCUMENSO_DISABLE_TELEMETRY=true

Docker

If you're using Docker, you can set this in your docker-compose.yml:

services:
  app:
    environment:
      - DOCUMENSO_DISABLE_TELEMETRY=true

Or pass it when running a container:

docker run -e DOCUMENSO_DISABLE_TELEMETRY=true ...

After Disabling

Once you set DOCUMENSO_DISABLE_TELEMETRY=true and restart your server, no telemetry data will be sent. The telemetry client will not initialize, and no network requests will be made to our telemetry servers.

If you previously had telemetry enabled, the installation ID stored in your database will remain, but it will no longer be used or sent anywhere.

Questions or Concerns

If you have questions about our telemetry practices or concerns about privacy, please reach out to us. We're committed to transparency and respect your choice to disable telemetry if you prefer.


See Also

On this page