Admin panel
beanguard-admin is the central place for managing your licence server — licences, orders, shop products, brand identity, users, mail and PDF templates, cryptographic keys, and the rest of the server's configuration.
Getting started
docker pull mszajner/beanguard-admin:0.1.3
docker run -d \
-p 8002:80 \
-e BEANGUARD_SERVER_URL=https://api.yourdomain.com \
mszajner/beanguard-admin:0.1.3
beanguard-admin is a thin Spring Boot server serving a pre-built React
frontend — all business logic lives in beanguard-server. You supply the
server address at container startup via BEANGUARD_SERVER_URL — the
frontend reads it at runtime from /config.js, so you don't need to
rebuild the image to point it at a different server.
First login
On its first startup, beanguard-server (not the admin panel) automatically creates an administrator account if there's no user in the database yet. You'll find the login credentials — including the password, shown only once — in the server container's logs:
docker compose logs server | grep -i admin
Go to the panel's address (e.g. http://localhost:8002 for a local Docker Compose setup from Quick start) and log in with those credentials. Change the password right after your first login — it's never stored anywhere in plain text outside that one-time startup log.
You add further administrators from within the panel itself — see Users.
Panel menu
The sidebar menu is split into three groups. Each item has its own detailed subpage:
Management
| Item | What it's for |
|---|---|
| Licences | Browsing, manually adding and editing customer licences, transfers, PDF certificates, DEMO licence configuration. |
Shop
| Item | What it's for |
|---|---|
| Orders | Orders placed in beanguard-shop — acceptance, cancellation, invoices. |
| Products | Products (limits and features) offered for sale in the shop. |
| Branding | Brand identity: name, logo, favicon, colour, support email. |
| Settings | Company details, sales and payments, legal documents, licence certificate. |
Administration
| Item | What it's for |
|---|---|
| Users | Panel administrator accounts and their roles. |
| Mail templates | Content and subject of transactional emails sent to customers. |
| PDF templates | The look of the licence certificate and pro-forma invoice. |
| Cryptographic keys | Issuer and RSA/AES keys, separately for licences and for admin sessions. |
| Parameters | Remaining server parameters without a dedicated screen (SMTP, rate limit). |
Changes to Branding settings only affect the panel's and shop's appearance after the application reloads — the panel will offer to do this once you save your changes.