← Documentation

Operator reference

Troubleshooting.

Isolate identity, origin, worker, and media failures before changing configuration.

License reports invalid

  • Confirm PORNOGRAPHER_IO_LICENSE_KEY and its neutral LICENSE_KEY alias exactly match the active key in your account.
  • Confirm PORNOGRAPHER_IO_LICENSE_SERVER_URL and its neutral LICENSE_SERVER_URL alias are reachable from the application host.
  • Confirm SITE_URL matches the origin pinned to the license.
  • Check expiry and renewal status before rotating credentials or redeploying.

Licensed domain changed

A Self-Host license is issued for one deployment. Contact support to review a legitimate origin change rather than starting a second order or editing the license response.

Update banner remains visible

Confirm the running image tag, apply the release's required migrations, and restart the web and worker services from the same release before checking the version endpoint again.

Upload or playback fails

Check worker heartbeat, queue state, available volume capacity, write permissions, public media-origin reachability, and signed playback from outside the application host.

Need operator help? Email support@pornographer.io.