Skip to content

QLens Web Portal

QLens 8.1 adds a browser portal on top of the Platform API. The portal is a runtime view over the canonical repository; it does not move research into SQLite.

Routes

Route Purpose
/ Redirects to login or dashboard
/login Browser sign-in
/dashboard Research overview
/repository Canonical object inventory
/research Research object view
/publications Publication overview
/administration IP, users, roles and audit view; owner-only
/docs OpenAPI documentation
/health Platform health

Start the platform

qlens platform init
qlens security ip add 127.0.0.1/32 --note "Local access"
qlens security user add mamun --password 'CHOOSE-A-STRONG-PASSWORD' --role owner
qlens platform serve --host 127.0.0.1 --port 8780

Open http://127.0.0.1:8780/ and sign in.

Production deployment

Use HTTPS through a trusted reverse proxy. Bind the application to loopback where possible and let Nginx or Caddy terminate TLS. Do not expose the runtime database or canonical repository as static files.

Browser sessions are:

  • stored as opaque tokens;
  • hashed in SQLite;
  • bound to the source IP;
  • sent in an HTTP-only cookie;
  • removable through the sign-out route.

The administration view requires the owner role.