Skip to main content
Version: v2 (current)

Licensing and first login for PanDev Metrics on-prem

TL;DR. On-prem licensing is handled directly with our team: you get a license key, paste it into the web UI on the first launch, create the admin account, and sign in — about three minutes from a running instance to the dashboard. For pricing, terms, and renewals, talk to us.

Contact us​

Reach out to start an on-prem license conversation or pick up a trial key.

We'll discuss your team size, deployment target (Docker or Kubernetes), and any compliance requirements, then issue a license key tied to your company.

What's included in on-prem​

An on-prem license covers the full PanDev Metrics product running on your infrastructure:

  • DORA metrics, IDE-hour analytics, finance/cost dashboards
  • All supported integrations: GitHub, GitLab, Bitbucket, Azure DevOps, Jira, Yandex Tracker, ClickUp, Azure Boards
  • IDE plugins (JetBrains, VS Code, Visual Studio, Xcode, Eclipse) and browser extensions
  • CLI agent (macOS, Linux)
  • LDAP / LDAPS / Active Directory authentication

On-prem runs a single organization per installation and uses LDAP / Active Directory for SSO. Multi-tenant workspaces and Google sign-in are Cloud-only today.

Before you begin​

You'll need a running PanDev Metrics instance, the license key, and credentials ready for the first admin account.

  • PanDev Metrics deployed, with the workspace UI reachable on port 8090 (or behind your reverse proxy on 443) — see Installation
  • License key on hand
  • Network access from your browser to the server
  • An email and a strong password for the first admin account

Step 1 — Open the web interface​

In your browser, go to the workspace UI:

address bar
http://<your-server>:8090

Replace <your-server> with the hostname or IP of the machine running PanDev Metrics. You'll land on the license activation form.

If the page doesn't load, check that the containers are up:

terminal
docker compose ps

pandev-metrics-server should be Up and postgres Up (healthy). If not, check docker compose logs pandev-metrics-server and see Network and ports.

Step 2 — Activate the license​

The activation form asks for two things: the license key and the credentials for the first admin.

  1. Paste the license key (company token) you received from us.
  2. Enter the email for the first admin — this becomes their login.
  3. Enter a strong password. Save it in your password manager — there's no recovery flow before LDAP or email is wired in.
  4. Select Start.

The system validates the key against our license server, then creates the admin account.

Step 3 — Sign in​

After activation you're redirected to the sign-in page.

  1. Enter the admin email.
  2. Enter the password.
  3. Select Sign in.

You land on the PanDev Metrics home dashboard. The dashboard is empty for now — that's expected. It fills up once you connect a Git host and let the IDE plugins start collecting activity.

Verify​

You're done when:

  • The dashboard URL http://<your-server>:8090/dashboard loads without redirecting back to the login page.
  • The user menu in the top-right shows your admin email.
  • Settings → Integrations is available.

Troubleshooting​

The activation form says "invalid license key"

Confirm the server can reach the license endpoint outbound (TCP 443), that system time is correct, and that you copied the key without trailing whitespace. If it still fails, message us on Telegram with your server URL and the time of the attempt.

The browser returns "connection refused"

The workspace container isn't up, or its port is blocked. From the host, run docker compose ps to check container status, then docker compose logs for whichever container is down. See Network and ports if a firewall is blocking the port.

I forgot the admin password

There's no password recovery before LDAP or SMTP is configured. You can reset it directly in the database — message us on Telegram for the safe reset procedure for your version.

FAQ​

Are there default credentials?​

No. PanDev Metrics doesn't ship with an admin / admin default. The first admin is created during the activation form when you paste the license key, with credentials you choose yourself.

How do I renew the license?​

Message us on Telegram before expiry. We'll issue a new key or extend the current one. The renewal is applied through the same activation form — no reinstall required.

Can I move the license to a different server?​

Yes. The license is tied to your company, not to a specific host. Spin up a new instance, restore your PostgreSQL dump with pg_dump / pg_restore, paste the same key, and you're back online. See the backups section of the install guide.

Can I change the admin email later?​

Yes. Once signed in, open the user profile and edit the email. The login changes immediately. Keep a second admin in the tenant before changing the primary one — you don't want to lock yourself out.

What if I deploy multiple environments — staging and production?​

Each instance needs its own license key activated separately, but one license can cover multiple environments — message us on Telegram. Each instance has its own admin account and database.

Is there a trial?​

Yes. The activation form is mandatory on first launch, but a trial license behaves like a full one for a limited period. Request one from us on Telegram.

How long does activation take?​

Typically a few seconds. The system makes one outbound HTTPS call to validate the key, then writes the tenant config to PostgreSQL. If activation takes longer than 30 seconds, check the server's outbound network access.

Next steps​

With the first admin account in place, hook up authentication and data sources.