# PowerSync Diagnostics App

PowerSync Diagnostics App is a self-hosted databases app. PowerSync Diagnostics is a tool for monitoring the health of your PowerSync database sync. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5775/powersync-diagnostics-app

## Description

PowerSync Diagnostics is a tool for monitoring the health of your PowerSync database sync. It identifies errors, tracks data flow, and keeps your data consistent between your server and client devices, helping you troubleshoot connection issues and confirm your system is running smoothly.

## Platform availability

Available on 0 of 10 platforms.

## Health score

75/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 3 days ago)
- Popular: 57 (742 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Security check: 100 (no serious findings, CI, tests)

## Links

- GitHub: https://github.com/powersync-ja/powersync-js
- Docker Hub: https://hub.docker.com/r/journeyapps/powersync-diagnostics-app
- Official website: https://www.powersync.com
- Documentation: https://docs.powersync.com/

## Common questions

### How do I connect the Diagnostics App to a self-hosted PowerSync service?

Connecting as a user requires a PowerSync Token, which is a JWT, and an Endpoint. For PowerSync development tokens, the endpoint is populated automatically from the JWT.

### What should I use when a client has stopped syncing?

The Diagnostics App can be used to check sync conflicts or errors and collect logs.

### What can the diagnostics client view or change?

It can view real-time sync status and bucket data, and manage client parameters.

### What Postgres storage setup do the docs recommend for PowerSync?

Use Docker to start a Postgres container, open port 5433 on your machine, and set a strong password. Give a dedicated user permission to create tables in powersync_storage, because without that setup PowerSync has no storage and cannot keep sync data.

---
Source: Our Local Host (https://ourlocalhost.com/app/5775/powersync-diagnostics-app), the self-hosted and open-source app directory.
