Skip to main content
Version: v2 (current)

First login to PanDev Metrics on-prem

TL;DR. Once PanDev Metrics is running on your server, the first launch takes about three minutes: open the web UI, paste the license key, create the admin account, and sign in. After that you're on the dashboard and ready to invite users.

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 and reachable on port 8080 (or behind your reverse proxy on 443) — see Installation
  • License key on hand — see Licensing
  • 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:

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

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 container is healthy:

terminal
curl -s http://<your-server>:9090/actuator/health

Expect {"status":"UP"}. If not, 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 sales@pandev.io.
  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>:8080/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​

Most first-login problems come down to network access or a typo in the license key. The known errors are below.

Details

The activation form says "invalid license key" Check that you copied the key without trailing whitespace. Confirm the server can reach the license endpoint outbound (TCP 443). If it still fails, write to support@pandev.io with the time of the attempt.

Details

The browser returns "connection refused" The backend container isn't up. From the host, run docker compose ps and check the status. Then curl -s http://localhost:9090/actuator/health from the server itself. See Network and ports if the port is blocked.

Details

I forgot the admin password There's no password recovery before LDAP or SMTP is configured. You can reset it directly in the database — contact support@pandev.io for the safe reset procedure for your version.

FAQ​

Common questions about the first launch of PanDev Metrics on-prem.

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.

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 — talk to sales@pandev.io. Each instance has its own admin account and database.

Can I skip the license step and run in trial mode?​

The activation form is mandatory on first launch. To evaluate, request a trial license from sales@pandev.io — it behaves like a full key for a limited period.

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.

Sideways reading on the same on-prem topic.