Initial Setup
On first launch, Stockaj Kiosk automatically displays the setup screen. This screen connects the kiosk to your Stockaj instance.
Configuration Fields
API URL
The address of your Stockaj server. The default value is:
https://app.stockaj.io/api/v2
Only change this value if you are using a self-hosted Stockaj instance.
API Token (Bearer Token)
The authentication token that allows the kiosk to communicate with the API. This token is generated from the Stockaj admin interface.
- Log in to your Stockaj interface
- Go to Settings → API Tokens
- Create a new token with kiosk permissions
- Copy the token and paste it into this field
The token is stored locally on the machine. Make sure only authorized personnel have access to the workstation.
PIN Code (optional)
A 4-digit code that protects access to this setup screen. If a PIN is set, it will be required every time a user tries to access settings from the navigation bar.
- Only digits are accepted
- Maximum 4 characters
- Leave empty to disable protection
Test Connection
Before saving, you can verify the connection works by clicking "Test Connection".
| Result | Display |
|---|---|
| ✅ Success | "Connection successful ✓" (green text) |
| ❌ Failure | "Failed ✗" followed by an error message (red text) |
Common Error Messages
| Message | Likely Cause |
|---|---|
| Unable to reach the server. | Incorrect URL or server unreachable |
| Unknown error. | Invalid token or network issue |
Save and Launch
Once the connection is tested successfully, click "Save and Launch" to save the configuration and access the cockpit.
Settings are persisted locally. You won't need to re-enter them on next launch, unless you reset the configuration.
Change Configuration Later
To return to this screen after initial setup:
- From the navigation bar, click the gear icon (⚙️) on the right
- If a PIN code is configured, enter it in the dialog
- The setup screen is displayed with the current values
