Choose the guide for your edition. Run Portable on your own computer or deploy Server on company infrastructure. Both editions are used in a browser. You will also find technical requirements and instructions for activation without internet access.
Download and run the software, activate the licence and load your first configuration. Learn where data is stored and how to update.
serverPrepare PostgreSQL, deploy the container and configure team access. The guide covers OpenShift, Docker and user accounts.
licenceActivate your key online or with a file. Learn how to renew licence verification and transfer an installation.
These variables configure startup. Portable uses defaults and usually needs no changes. For Server, pass configuration through container variables or mounted secret files.
| variable | edition | meaning |
|---|---|---|
| WEBCON_LICENSE | both | licence key WCR1.…. An alternative to pasting it in Settings; the variable takes precedence. |
| WEBCON_LICENSE_FILE | both | path to a key file, e.g. a Secret mounted in the container. |
| WEBCON_LICENSE_SERVER | both | licence server URL; default: https://licencje.viewer-pro.pl. Change only for an internal proxy. |
| WEBCON_LICENSE_OFFLINE | both | 1 disables licence server connections; verification is read from the lease file (offline mode). |
| WC_PG_URL | server | PostgreSQL connection URL, e.g. postgres://viewer:haslo@pg.firma.local:5432/viewer_pro. Required to start the Server edition. |
| WEBCON_SECRET_KEY | server | secret vault key (SQL profile passwords, AI keys): 32 random bytes in base64. Alternatively, WEBCON_SECRET_KEY_FILE with a path. Changing the key makes saved secrets unreadable; they must be entered again. |
| PORT | server | HTTP port; default: 8080. OpenShift supplies it automatically. |
| WEBCON_DB | portable | application data directory. Default: %LOCALAPPDATA%\ViewerPro on Windows and ~/.local/share/viewer-pro on Linux and macOS. |
| Portable | Server | |
|---|---|---|
| operating system | Windows 10/11 x64, Linux x64, macOS (Apple Silicon) | OpenShift 4.x, Kubernetes 1.25+ or Docker / Podman |
| database | included; no separate installation needed | PostgreSQL meeting the edition's requirements; database setup |
| browser | Chrome, Edge, Firefox, Safari — current versions | |
| memory | 2 GB of free memory as a starting point; requirements depend on configuration size | size container and database resources according to configuration size and user count |
| disk | space for configuration, history and backups; determine capacity during the pilot based on environment count and history retention | |
| network | HTTPS to the licence server daily or an offline lease file; MS SQL if using profiles; AI provider if descriptions are enabled | |
Both editions support the same commands. In Portable, run them through the start script; in Server, inside the container using oc exec or docker exec.
# import kompletu paczek jako nowy punkt w czasie srodowiska DEV w workspace KLIENT
viewer-pro ingest import "C:\eksport\*.bpe" --workspace KLIENT --env DEV
# pobranie stanu z profilu MS SQL zapisanego w Ustawieniach (nowy punkt w czasie)
viewer-pro sql import --env PROD
# licencja: zadanie offline i wczytanie dzierzawy
viewer-pro sql license-request > viewer-pro-request.json
viewer-pro sql license-lease viewer-pro-lease.jsonIn the Server edition, the plan for companies specifies the number of active users, while the plan for WEBCON partners sets the number of clients. One client corresponds to one workspace. Portable has separate limits shown in the table. A user counts when their active account has access or administrator permissions and has signed in within the last 90 days. A workspace counts after the first snapshot is saved in any of its environments.
| plan | intended for | users | workspaces | environments |
|---|---|---|---|---|
| Portable | one person | 1 | 1 | 4 |
| Server 5 | company | 5 | 1 | unlimited |
| Server 20 | company | 20 | 1 | unlimited |
| Server unlimited | company | unlimited | 1 | unlimited |
| Partner 5 | WEBCON partner | unlimited | 5 | unlimited |
| Partner 15 | WEBCON partner | unlimited | 15 | unlimited |
| Partner unlimited | WEBCON partner | unlimited | unlimited | unlimited |
| trial (30 days) | both editions | unlimited | unlimited | unlimited |
After reaching the limit, the software prevents adding another account, workspace or environment and displays a message. Existing data remains accessible. Disabling an account or 90 days without sign-in frees a user slot. After a downgrade, workspaces above the limit cannot accept new snapshots, but their history remains readable. Request an upgrade quote.
Before updating, back up PostgreSQL (Server) or the data directory with the application stopped (Portable). Follow the instructions included with the release. Saved snapshots remain available. Returning to an older version requires restoring a pre-update backup; do not run it against data updated by a newer release.