Settings

The Settings module contains your device’s configurable options — authentication, security, and diagnostics.

API Keys

Each ProxyBox ships with an enabled key named Default. You can create additional named keys, rename them, turn them on or off, and delete them. Use the eye button to reveal a key and the copy button to copy its full value.

The API Key option controls authentication for the printer, job, discovery, and print API routes. When set to Required, external API clients must send an enabled key in the X-API-Key header. When set to Optional, those routes are open. Other management routes still require authentication in either mode.

API key management and changing the Required or Optional setting are available only from a logged-in browser session. An API key cannot manage keys or change this setting, and settings requests authenticated by an API key do not return the key list.

You can turn off or delete every key. If the API Key option is Required and no key is enabled, external API requests are rejected until you enable or create a key.

Note

For development and testing, you can set API Key to Optional. In production, keep it Required — especially if you’re using the .cloud tunnel, since your API is accessible from the public internet.

Password

Enter the new password in New password… and Confirm new password…, then select Update Password. The entries must match and be at least 8 characters. After the password changes, your current browser session stays signed in and every other session is logged out.

Recovery Code

Select Show recovery code to reveal the QR code and secret string used to enroll an authenticator app. Store this secret securely.

If you forget the admin password, enter a current six-digit code from the authenticator app in the login Password field. After signing in, set a new password in Settings.

Raw Debug

Enables detailed diagnostic logging during print operations. When turned on, ProxyBox logs the raw data sent to and received from printers — useful for troubleshooting print formatting issues or verifying that the right data is reaching the printer.

Leave this off in normal operation. Turn it on when you’re actively debugging a print problem.

Force Cloud Check-in

Forces an immediate sync with the cloud management platform. Normally, your device checks in on a schedule. Use this after making configuration changes you want reflected in the cloud dashboard right away.