Some test text!

Common Issueskeyboard_arrow_down

Common Issues

linkHow do I use my PDFTron license?

WebViewer Server requires that you place your key in both

  • The WebViewer Server configuration
  • The WebViewer client constructor

On the client side the key would be used like so:

  licenseKey: 'Company info::The PDFTron license info::Testing::More info::123',
  path: '...'
}).then((instance) => {


On the server side, place the key in your docker-compose.yaml file under pdfd-tomcat > environment:

     TRN_PDFNET_KEY: 'Company info::The PDFTron license info::Testing::More info::123'

If you are using the Windows installer, you would place the key within the wvs_config.json as detailed here.

linkI've built WebViewer Server into my infrastructure but am getting 404 errors

There are generally 2 possible reasons for this at an infrastructure level:

  1. Your infrastructure is not handling Websockets correctly.
  2. Your infrastructure is not correctly handling cookie stickiness.

To verify that the connection is being maintained, you should verify that the Websocket isn't being broken at the load balancer level.

To verify the cookie stickiness, you can check the cookies of incoming and out going requests. The cookie HAPROXID should maintain its value while loading a single document.

linkCan I use the network load balancer on Amazon Web Services?

The network load balancer does not support Websockets, however, the classic and application balancers do.

linkMy server is disconnecting when using an AWS classic load balancer

If using the classic load balancer all communication will have to be done over SSL and TCP ports rather than HTTP and HTTPS. This is because this balancer does not provide native support for Websockets.

linkMy non PDF documents are failing when using WebViewer Server

If the links you're providing to WebViewer Server do not have a file extension, you may need to pass an extension. This would need to be passed as an argument to loadDocument ext option or through the formatting of the file name. Otherwise WebViewer Server will treat it as if it were a PDF and act accordingly.

linkMy server has failed to fetch a document

Ensure that the document you are sending is accessible from the remote location you are requesting it from WebViewer Server's hosted location.

If it cannot retrieve the document, this may be because authentication is incorrect or the file is not physically accessible from WebViewer Server.

You can verify if it's physically accessible by requesting the file from your WebViewer Server host.

If authentication is the issue, you may find our cookie forwarding options or custom headers options helpful.

linkMy server hard disk is running out of space

You may need to reconfigure your caching options. The default behaviour for WebViewer Server's caching can be found here. We still recommend at least 50GB of disk space to ensure that disk space cannot be consumed faster than the server can produce it.

It's possible that your docker images have taken up too much disk space, you can clear unused docker image space by running the docker system prune command. You may also see what space is used by calling docker system df.

Get the answers you need: Support


Free Trial

Get unlimited trial usage of PDFTron SDK to bring accurate, reliable, and fast document processing capabilities to any application or workflow.

Select a platform to get started with your free trial.

Unlimited usage. No email address required.

Join our live demo to learn about use cases & capabilities for WebViewer

Learn more