HyperDX

v2.38.0

HyperDX searches and visualizes logs, traces, metrics, and session replays. Includes ClickHouse, MongoDB, and the ClickStack OpenTelemetry collector.

monitoring logging observability

Deploy on Dokploy

Website GitHub Documentation

Deploy HyperDX on Dokploy

Install Dokploy on your server if you haven't already.
In your Dokploy panel, open a project and click Create Service → Template.
Search for HyperDX and click Create — Dokploy configures domains, environment variables, and volumes for you.

Alternatively, create a Compose service, go to Advanced → Import from Base64, and paste this payload:

base64

ewogICJjb21wb3NlIjogInNlcnZpY2VzOlxuICBoeXBlcmR4OlxuICAgIGltYWdlOiBoeXBlcmR4L2h5cGVyZHg6Mi4zOC4wXG4gICAgcmVzdGFydDogdW5sZXNzLXN0b3BwZWRcbiAgICBkZXBlbmRzX29uOlxuICAgICAgbW9uZ29kYjpcbiAgICAgICAgY29uZGl0aW9uOiBzZXJ2aWNlX2hlYWx0aHlcbiAgICAgIGNsaWNraG91c2U6XG4gICAgICAgIGNvbmRpdGlvbjogc2VydmljZV9oZWFsdGh5XG4gICAgZW52aXJvbm1lbnQ6XG4gICAgICBGUk9OVEVORF9VUkw6ICR7SFlQRVJEWF9VUkw6P1NldCB0aGUgcHVibGljIEh5cGVyRFggVVJMfVxuICAgICAgSFlQRVJEWF9BUFBfVVJMOiAke0hZUEVSRFhfVVJMOj9TZXQgdGhlIHB1YmxpYyBIeXBlckRYIFVSTH1cbiAgICAgIEhZUEVSRFhfQVBQX1BPUlQ6IFwiODA4MFwiXG4gICAgICBIWVBFUkRYX0FQSV9QT1JUOiBcIjgwMDBcIlxuICAgICAgU0VSVkVSX1VSTDogaHR0cDovLzEyNy4wLjAuMTo4MDAwXG4gICAgICBPUEFNUF9QT1JUOiBcIjQzMjBcIlxuICAgICAgTU9OR09fVVJJOiBtb25nb2RiOi8vbW9uZ29kYjoyNzAxNy9oeXBlcmR4XG4gICAgICBFWFBSRVNTX1NFU1NJT05fU0VDUkVUOiAke1NFU1NJT05fU0VDUkVUOj9TZXQgdGhlIHNlc3Npb24gc2VjcmV0fVxuICAgICAgSFlQRVJEWF9MT0dfTEVWRUw6IGluZm9cbiAgICAgIFVTQUdFX1NUQVRTX0VOQUJMRUQ6IFwiZmFsc2VcIlxuICAgICAgTkVYVF9URUxFTUVUUllfRElTQUJMRUQ6IFwiMVwiXG4gICAgICBERUZBVUxUX0NPTk5FQ1RJT05TOiAnW3tcIm5hbWVcIjpcIkxvY2FsXG4gICAgICAgIENsaWNrSG91c2VcIixcImhvc3RcIjpcImh0dHA6Ly9jbGlja2hvdXNlOjgxMjNcIixcInVzZXJuYW1lXCI6XCJoeXBlcmR4XCIsXCJwYXNzd29yZFwiOlwiJHtDTElDS0hPVVNFX1BBU1NXT1JEfVwifV0nXG4gICAgICBERUZBVUxUX1NPVVJDRVM6ICdbe1wiZnJvbVwiOntcImRhdGFiYXNlTmFtZVwiOlwiZGVmYXVsdFwiLFwidGFibGVOYW1lXCI6XCJvdGVsX2xvZ3NcIn0sXCJraW5kXCI6XCJsb2dcIixcInRpbWVzdGFtcFZhbHVlRXhwcmVzc2lvblwiOlwiVGltZXN0YW1wXCIsXCJuYW1lXCI6XCJMb2dzXCIsXCJkaXNwbGF5ZWRUaW1lc3RhbXBWYWx1ZUV4cHJlc3Npb25cIjpcIlRpbWVzdGFtcFwiLFwiaW1wbGljaXRDb2x1bW5FeHByZXNzaW9uXCI6XCJCb2R5XCIsXCJzZXJ2aWNlTmFtZUV4cHJlc3Npb25cIjpcIlNlcnZpY2VOYW1lXCIsXCJib2R5RXhwcmVzc2lvblwiOlwiQm9keVwiLFwiZXZlbnRBdHRyaWJ1dGVzRXhwcmVzc2lvblwiOlwiTG9nQXR0cmlidXRlc1wiLFwicmVzb3VyY2VBdHRyaWJ1dGVzRXhwcmVzc2lvblwiOlwiUmVzb3VyY2VBdHRyaWJ1dGVzXCIsXCJkZWZhdWx0VGFibGVTZWxlY3RFeHByZXNzaW9uXCI6XCJUaW1lc3RhbXAsU2VydmljZU5hbWUsU2V2ZXJpdHlUZXh0LEJvZHlcIixcInNldmVyaXR5VGV4dEV4cHJlc3Npb25cIjpcIlNldmVyaXR5VGV4dFwiLFwidHJhY2VJZEV4cHJlc3Npb25cIjpcIlRyYWNlSWRcIixcInNwYW5JZEV4cHJlc3Npb25cIjpcIlNwYW5JZFwiLFwibWV0YWRhdGFNYXRlcmlhbGl6ZWRWaWV3c1wiOntcImtleVJvbGx1cFRhYmxlXCI6XCJvdGVsX2xvZ3Nfa2V5X3JvbGx1cF8xNW1cIixcImt2Um9sbHVwVGFibGVcIjpcIm90ZWxfbG9nc19rdl9yb2xsdXBfMTVtXCIsXCJncmFudWxhcml0eVwiOlwiMTVcbiAgICAgICAgbWludXRlXCJ9LFwiY29ubmVjdGlvblwiOlwiTG9jYWxcbiAgICAgICAgQ2xpY2tIb3VzZVwiLFwidHJhY2VTb3VyY2VJZFwiOlwiVHJhY2VzXCIsXCJzZXNzaW9uU291cmNlSWRcIjpcIlNlc3Npb25zXCIsXCJtZXRyaWNTb3VyY2VJZFwiOlwiTWV0cmljc1wifSx7XCJmcm9tXCI6e1wiZGF0YWJhc2VOYW1lXCI6XCJkZWZhdWx0XCIsXCJ0YWJsZU5hbWVcIjpcIm90ZWxfdHJhY2VzXCJ9LFwia2luZFwiOlwidHJhY2VcIixcInRpbWVzdGFtcFZhbHVlRXhwcmVzc2lvblwiOlwiVGltZXN0YW1wXCIsXCJuYW1lXCI6XCJUcmFjZXNcIixcImRpc3BsYXllZFRpbWVzdGFtcFZhbHVlRXhwcmVzc2lvblwiOlwiVGltZXN0YW1wXCIsXCJpbXBsaWNpdENvbHVtbkV4cHJlc3Npb25cIjpcIlNwYW5OYW1lXCIsXCJzZXJ2aWNlTmFtZUV4cHJlc3Npb25cIjpcIlNlcnZpY2VOYW1lXCIsXCJldmVudEF0dHJpYnV0ZXNFeHByZXNzaW9uXCI6XCJTcGFuQXR0cmlidXRlc1wiLFwicmVzb3VyY2VBdHRyaWJ1dGVzRXhwcmVzc2lvblwiOlwiUmVzb3VyY2VBdHRyaWJ1dGVzXCIsXCJkZWZhdWx0VGFibGVTZWxlY3RFeHByZXNzaW9uXCI6XCJUaW1lc3RhbXAsU2VydmljZU5hbWUsU3RhdHVzQ29kZSxyb3VuZChEdXJhdGlvbi8xZTYpLFNwYW5OYW1lXCIsXCJ0cmFjZUlkRXhwcmVzc2lvblwiOlwiVHJhY2VJZFwiLFwic3BhbklkRXhwcmVzc2lvblwiOlwiU3BhbklkXCIsXCJkdXJhdGlvbkV4cHJlc3Npb25cIjpcIkR1cmF0aW9uXCIsXCJkdXJhdGlvblByZWNpc2lvblwiOjksXCJwYXJlbnRTcGFuSWRFeHByZXNzaW9uXCI6XCJQYXJlbnRTcGFuSWRcIixcInNwYW5OYW1lRXhwcmVzc2lvblwiOlwiU3Bhbk5hbWVcIixcInNwYW5LaW5kRXhwcmVzc2lvblwiOlwiU3BhbktpbmRcIixcInN0YXR1c0NvZGVFeHByZXNzaW9uXCI6XCJTdGF0dXNDb2RlXCIsXCJzdGF0dXNNZXNzYWdlRXhwcmVzc2lvblwiOlwiU3RhdHVzTWVzc2FnZVwiLFwibWV0YWRhdGFNYXRlcmlhbGl6ZWRWaWV3c1wiOntcImtleVJvbGx1cFRhYmxlXCI6XCJvdGVsX3RyYWNlc19rZXlfcm9sbHVwXzE1bVwiLFwia3ZSb2xsdXBUYWJsZVwiOlwib3RlbF90cmFjZXNfa3Zfcm9sbHVwXzE1bVwiLFwiZ3JhbnVsYXJpdHlcIjpcIjE1XG4gICAgICAgIG1pbnV0ZVwifSxcImNvbm5lY3Rpb25cIjpcIkxvY2FsXG4gICAgICAgIENsaWNrSG91c2VcIixcImxvZ1NvdXJjZUlkXCI6XCJMb2dzXCIsXCJzZXNzaW9uU291cmNlSWRcIjpcIlNlc3Npb25zXCIsXCJtZXRyaWNTb3VyY2VJZFwiOlwiTWV0cmljc1wifSx7XCJmcm9tXCI6e1wiZGF0YWJhc2VOYW1lXCI6XCJkZWZhdWx0XCIsXCJ0YWJsZU5hbWVcIjpcIlwifSxcImtpbmRcIjpcIm1ldHJpY1wiLFwidGltZXN0YW1wVmFsdWVFeHByZXNzaW9uXCI6XCJUaW1lVW5peFwiLFwibmFtZVwiOlwiTWV0cmljc1wiLFwicmVzb3VyY2VBdHRyaWJ1dGVzRXhwcmVzc2lvblwiOlwiUmVzb3VyY2VBdHRyaWJ1dGVzXCIsXCJtZXRyaWNUYWJsZXNcIjp7XCJnYXVnZVwiOlwib3RlbF9tZXRyaWNzX2dhdWdlXCIsXCJoaXN0b2dyYW1cIjpcIm90ZWxfbWV0cmljc19oaXN0b2dyYW1cIixcInN1bVwiOlwib3RlbF9tZXRyaWNzX3N1bVwiLFwiZXhwb25lbnRpYWwgaGlzdG9ncmFtXCI6XCJvdGVsX21ldHJpY3NfZXhwb25lbnRpYWxfaGlzdG9ncmFtXCIsXCJfaWRcIjpcIjY4MjU4NmE4YjFmODE5MjRlNjI4ZTgwOFwiLFwiaWRcIjpcIjY4MjU4NmE4YjFmODE5MjRlNjI4ZTgwOFwifSxcImNvbm5lY3Rpb25cIjpcIkxvY2FsXG4gICAgICAgIENsaWNrSG91c2VcIixcImxvZ1NvdXJjZUlkXCI6XCJMb2dzXCIsXCJ0cmFjZVNvdXJjZUlkXCI6XCJUcmFjZXNcIixcInNlc3Npb25Tb3VyY2VJZFwiOlwiU2Vzc2lvbnNcIn0se1wiZnJvbVwiOntcImRhdGFiYXNlTmFtZVwiOlwiZGVmYXVsdFwiLFwidGFibGVOYW1lXCI6XCJoeXBlcmR4X3Nlc3Npb25zXCJ9LFwia2luZFwiOlwic2Vzc2lvblwiLFwidGltZXN0YW1wVmFsdWVFeHByZXNzaW9uXCI6XCJUaW1lc3RhbXBUaW1lXCIsXCJuYW1lXCI6XCJTZXNzaW9uc1wiLFwiZGlzcGxheWVkVGltZXN0YW1wVmFsdWVFeHByZXNzaW9uXCI6XCJUaW1lc3RhbXBcIixcImltcGxpY2l0Q29sdW1uRXhwcmVzc2lvblwiOlwiQm9keVwiLFwic2VydmljZU5hbWVFeHByZXNzaW9uXCI6XCJTZXJ2aWNlTmFtZVwiLFwiYm9keUV4cHJlc3Npb25cIjpcIkJvZHlcIixcImV2ZW50QXR0cmlidXRlc0V4cHJlc3Npb25cIjpcIkxvZ0F0dHJpYnV0ZXNcIixcInJlc291cmNlQXR0cmlidXRlc0V4cHJlc3Npb25cIjpcIlJlc291cmNlQXR0cmlidXRlc1wiLFwiZGVmYXVsdFRhYmxlU2VsZWN0RXhwcmVzc2lvblwiOlwiVGltZXN0YW1wLFNlcnZpY2VOYW1lLFNldmVyaXR5VGV4dCxCb2R5XCIsXCJzZXZlcml0eVRleHRFeHByZXNzaW9uXCI6XCJTZXZlcml0eVRleHRcIixcInRyYWNlSWRFeHByZXNzaW9uXCI6XCJUcmFjZUlkXCIsXCJzcGFuSWRFeHByZXNzaW9uXCI6XCJTcGFuSWRcIixcImNvbm5lY3Rpb25cIjpcIkxvY2FsXG4gICAgICAgIENsaWNrSG91c2VcIixcImxvZ1NvdXJjZUlkXCI6XCJMb2dzXCIsXCJ0cmFjZVNvdXJjZUlkXCI6XCJUcmFjZXNcIixcIm1ldHJpY1NvdXJjZUlkXCI6XCJNZXRyaWNzXCJ9XSdcbiAgICBleHBvc2U6XG4gICAgICAtIFwiODA4MFwiXG4gICAgaGVhbHRoY2hlY2s6XG4gICAgICB0ZXN0OlxuICAgICAgICAtIENNRFxuICAgICAgICAtIG5vZGVcbiAgICAgICAgLSAtZVxuICAgICAgICAtIHJlcXVpcmUoJ2h0dHAnKS5nZXQoJ2h0dHA6Ly8xMjcuMC4wLjE6ODA4MC9hcGkvcmVhZHknLHI9PnByb2Nlc3MuZXhpdChyLnN0YXR1c0NvZGU9PT0yMDA/MDoxKSkub24oJ2Vycm9yJywoKT0+cHJvY2Vzcy5leGl0KDEpKVxuICAgICAgaW50ZXJ2YWw6IDMwc1xuICAgICAgdGltZW91dDogNXNcbiAgICAgIHJldHJpZXM6IDVcbiAgICAgIHN0YXJ0X3BlcmlvZDogNjBzXG4gIG1vbmdvZGI6XG4gICAgaW1hZ2U6IG1vbmdvOjguMC4yOVxuICAgIHJlc3RhcnQ6IHVubGVzcy1zdG9wcGVkXG4gICAgY29tbWFuZDpcbiAgICAgIC0gbW9uZ29kXG4gICAgICAtIC0td2lyZWRUaWdlckNhY2hlU2l6ZUdCXG4gICAgICAtIFwiMC4yNVwiXG4gICAgdm9sdW1lczpcbiAgICAgIC0gbW9uZ29kYi1kYXRhOi9kYXRhL2RiXG4gICAgICAtIG1vbmdvZGItY29uZmlnOi9kYXRhL2NvbmZpZ2RiXG4gICAgaGVhbHRoY2hlY2s6XG4gICAgICB0ZXN0OlxuICAgICAgICAtIENNRFxuICAgICAgICAtIG1vbmdvc2hcbiAgICAgICAgLSAtLXF1aWV0XG4gICAgICAgIC0gLS1ldmFsXG4gICAgICAgIC0gXCJxdWl0KGRiLmFkbWluQ29tbWFuZCgncGluZycpLm9rID8gMCA6IDEpXCJcbiAgICAgIGludGVydmFsOiAzMHNcbiAgICAgIHRpbWVvdXQ6IDEwc1xuICAgICAgcmV0cmllczogNVxuICAgICAgc3RhcnRfcGVyaW9kOiAzMHNcbiAgY2xpY2tob3VzZTpcbiAgICBpbWFnZTogY2xpY2tob3VzZS9jbGlja2hvdXNlLXNlcnZlcjoyNi41LjcuNjQtYWxwaW5lXG4gICAgcmVzdGFydDogdW5sZXNzLXN0b3BwZWRcbiAgICBlbnZpcm9ubWVudDpcbiAgICAgIENMSUNLSE9VU0VfVVNFUjogaHlwZXJkeFxuICAgICAgQ0xJQ0tIT1VTRV9QQVNTV09SRDogJHtDTElDS0hPVVNFX1BBU1NXT1JEOj9TZXQgdGhlIENsaWNrSG91c2UgcGFzc3dvcmR9XG4gICAgICBDTElDS0hPVVNFX0RFRkFVTFRfQUNDRVNTX01BTkFHRU1FTlQ6IFwiMVwiXG4gICAgdWxpbWl0czpcbiAgICAgIG5vZmlsZTpcbiAgICAgICAgc29mdDogMjYyMTQ0XG4gICAgICAgIGhhcmQ6IDI2MjE0NFxuICAgIHZvbHVtZXM6XG4gICAgICAtIGNsaWNraG91c2UtZGF0YTovdmFyL2xpYi9jbGlja2hvdXNlXG4gICAgICAtIGNsaWNraG91c2UtbG9nczovdmFyL2xvZy9jbGlja2hvdXNlLXNlcnZlclxuICAgICAgLSAuLi9maWxlcy9jbGlja2hvdXNlLWNvbmZpZy54bWw6L2V0Yy9jbGlja2hvdXNlLXNlcnZlci9jb25maWcuZC9oeXBlcmR4LnhtbDpyb1xuICAgIGhlYWx0aGNoZWNrOlxuICAgICAgdGVzdDpcbiAgICAgICAgLSBDTURcbiAgICAgICAgLSB3Z2V0XG4gICAgICAgIC0gLS1xdWlldFxuICAgICAgICAtIC0tc3BpZGVyXG4gICAgICAgIC0gaHR0cDovLzEyNy4wLjAuMTo4MTIzL3BpbmdcbiAgICAgIGludGVydmFsOiAzMHNcbiAgICAgIHRpbWVvdXQ6IDVzXG4gICAgICByZXRyaWVzOiA1XG4gICAgICBzdGFydF9wZXJpb2Q6IDYwc1xuICBvdGVsLWNvbGxlY3RvcjpcbiAgICBpbWFnZTogY2xpY2tob3VzZS9jbGlja3N0YWNrLW90ZWwtY29sbGVjdG9yOjIuMzguMFxuICAgIHJlc3RhcnQ6IHVubGVzcy1zdG9wcGVkXG4gICAgZGVwZW5kc19vbjpcbiAgICAgIGNsaWNraG91c2U6XG4gICAgICAgIGNvbmRpdGlvbjogc2VydmljZV9oZWFsdGh5XG4gICAgICBoeXBlcmR4OlxuICAgICAgICBjb25kaXRpb246IHNlcnZpY2VfaGVhbHRoeVxuICAgIGVudmlyb25tZW50OlxuICAgICAgQ0xJQ0tIT1VTRV9FTkRQT0lOVDogdGNwOi8vY2xpY2tob3VzZTo5MDAwP2RpYWxfdGltZW91dD0xMHNcbiAgICAgIENMSUNLSE9VU0VfVVNFUjogaHlwZXJkeFxuICAgICAgQ0xJQ0tIT1VTRV9QQVNTV09SRDogJHtDTElDS0hPVVNFX1BBU1NXT1JEOj9TZXQgdGhlIENsaWNrSG91c2UgcGFzc3dvcmR9XG4gICAgICBIWVBFUkRYX09URUxfRVhQT1JURVJfQ0xJQ0tIT1VTRV9EQVRBQkFTRTogZGVmYXVsdFxuICAgICAgSFlQRVJEWF9PVEVMX0VYUE9SVEVSX0NSRUFURV9MRUdBQ1lfU0NIRU1BOiBcInRydWVcIlxuICAgICAgT1BBTVBfU0VSVkVSX1VSTDogaHR0cDovL2h5cGVyZHg6NDMyMFxuICAgICAgSFlQRVJEWF9MT0dfTEVWRUw6IGluZm9cbiAgICBleHBvc2U6XG4gICAgICAtIFwiNDMxN1wiXG4gICAgICAtIFwiNDMxOFwiXG4gICAgdm9sdW1lczpcbiAgICAgIC0gb3RlbC1zdXBlcnZpc29yOi9ldGMvb3RlbC9zdXBlcnZpc29yLWRhdGFcbnZvbHVtZXM6XG4gIG1vbmdvZGItZGF0YToge31cbiAgbW9uZ29kYi1jb25maWc6IHt9XG4gIGNsaWNraG91c2UtZGF0YToge31cbiAgY2xpY2tob3VzZS1sb2dzOiB7fVxuICBvdGVsLXN1cGVydmlzb3I6IHt9IiwKICAiY29uZmlnIjogIlt2YXJpYWJsZXNdXG5tYWluX2RvbWFpbiA9IFwiJHtkb21haW59XCJcbnNlc3Npb25fc2VjcmV0ID0gXCIke3Bhc3N3b3JkOjY0fVwiXG5jbGlja2hvdXNlX3Bhc3N3b3JkID0gXCIke3Bhc3N3b3JkOjMyfVwiXG5cbltjb25maWddXG5lbnYgPSBbXG4gIFwiSFlQRVJEWF9VUkw9aHR0cDovLyR7bWFpbl9kb21haW59XCIsXG4gIFwiU0VTU0lPTl9TRUNSRVQ9JHtzZXNzaW9uX3NlY3JldH1cIixcbiAgXCJDTElDS0hPVVNFX1BBU1NXT1JEPSR7Y2xpY2tob3VzZV9wYXNzd29yZH1cIlxuXVxuXG5bW2NvbmZpZy5kb21haW5zXV1cbnNlcnZpY2VOYW1lID0gXCJoeXBlcmR4XCJcbnBvcnQgPSA4MDgwXG5ob3N0ID0gXCIke21haW5fZG9tYWlufVwiXG5cbltbY29uZmlnLm1vdW50c11dXG5maWxlUGF0aCA9IFwiY2xpY2tob3VzZS1jb25maWcueG1sXCJcbmNvbnRlbnQgPSBcIlwiXCJcbjxjbGlja2hvdXNlPlxuICA8bG9nZ2VyPlxuICAgIDxsZXZlbD53YXJuaW5nPC9sZXZlbD5cbiAgPC9sb2dnZXI+XG4gIDxjdXN0b21fc2V0dGluZ3NfcHJlZml4ZXM+aHlwZXJkeDwvY3VzdG9tX3NldHRpbmdzX3ByZWZpeGVzPlxuICA8bWF4X3NlcnZlcl9tZW1vcnlfdXNhZ2U+MjE0NzQ4MzY0ODwvbWF4X3NlcnZlcl9tZW1vcnlfdXNhZ2U+XG4gIDxtYXJrX2NhY2hlX3NpemU+MTM0MjE3NzI4PC9tYXJrX2NhY2hlX3NpemU+XG4gIDx1bmNvbXByZXNzZWRfY2FjaGVfc2l6ZT42NzEwODg2NDwvdW5jb21wcmVzc2VkX2NhY2hlX3NpemU+XG48L2NsaWNraG91c2U+XG5cIlwiXCIiCn0=

Configuration

The exact Docker Compose and template configuration this template deploys.

Instructions

HyperDX

This template deploys HyperDX with MongoDB, ClickHouse, and the ClickStack OpenTelemetry collector. It uses HyperDX's authenticated application image. Logs, traces, metrics, and session replay sources are configured automatically when you create the first account.

Before deploying

Use an x86-64 server with AVX support for MongoDB, at least 2 CPU cores, and 4 GiB of available RAM for testing. Reserve more memory and disk space for production workloads.

Keep Dokploy's isolated deployment enabled. MongoDB has no authentication and must remain on the private application network. ClickHouse uses a generated password. Neither database needs a public port.

The ClickHouse configuration starts with a 2 GiB server memory budget and small caches. Adjust clickhouse-config.xml in Dokploy's file mounts for your workload and available memory. This setting is ClickHouse's accounting limit, not a hard container RAM limit.

Open the assigned domain and create the first account. HyperDX allows one initial team; invite additional users from that team after setup. Complete this step before sharing the domain.

When enabling HTTPS or changing the domain in Dokploy, set HYPERDX_URL to the matching origin, such as https://hyperdx.example.com, and redeploy. Use HTTPS before sending credentials over an untrusted network. The web interface proxies API requests internally, so you do not need to publish API port 8000.

Keep SESSION_SECRET stable across redeployments. If you change CLICKHOUSE_PASSWORD after creating your account, also update the saved ClickHouse connection in HyperDX.

Send telemetry

Copy the ingestion API key from HyperDX's team settings. This key is different from the personal API key used to query HyperDX's API.

For senders on the private application network:


text

For external senders, add a domain in Dokploy for service otel-collector, port 4318, enable HTTPS, and use that URL as the OTLP endpoint. HTTP/protobuf telemetry uses /v1/logs, /v1/traces, and /v1/metrics beneath that endpoint. The collector requires the ingestion API key after the first team is created.

For OTLP gRPC, publish an unused host port to collector port 4317 in Dokploy's Compose editor and restrict access to trusted senders. Ordinary HTTP domain routing does not configure gRPC ingestion automatically. The template publishes no host ports by default.

Persistence

MongoDB volumes store accounts, connections, dashboards, and saved searches. ClickHouse volumes store telemetry and server logs. The collector volume retains its supervisor state. Preserve these volumes during redeployments and back up MongoDB and ClickHouse before upgrading.

Usage reporting and Next.js telemetry are disabled by default. Configure retention in ClickHouse for the volume of telemetry you expect.

Related Templates

Parseable

Version: v1.6.5

Fast observability and log analytics platform on object storage

observabilitylogginganalytics

Seq

Version: 2025.2

Seq is a self-hosted search, analysis, and alerting server for structured application logs and events.

loggingobservabilitymonitoring

Dokploy Prometheus Monitoring Extension

Version: canary

Dokploy monitoring extension with Prometheus metrics export for external monitoring systems like Grafana Cloud. Tracks server and container metrics with configurable thresholds and alerting.

monitoringprometheusmetrics