pdfRest PDF Toolkit Self-Hosted API

The pdfRest PDF Toolkit Self-Hosted API product is provided as an Amazon Machine Image (AMI). This AMI is a snapshot of a server configuration and is available on the AWS Marketplace. It can be used as a template to deploy your own server instance, allowing you to add our PDF processing features to your own AWS environment or build your own custom workflows that you can run on demand.

The pdfRest PDF Toolkit Self-Hosted API Reference Guide can be found here.

Launching an EC2 Instance

For this process you’ll need to have already subscribed to the pdfRest PDF Toolkit Self-Hosted API product on our AWS Marketplace page.

Setting up your EC2 instance

These steps assume that you have successfully launched an instance by following the steps found above for Launching an instance.

Adding msCoreFonts to your instance

Follow these steps to get the most out of Compress PDF, Convert to PDF/A, and Watermark PDF by installing and enabling msCoreFonts.

Setting up EFS for EC2

Follow these instructions to manually set up Amazon Elastic File System (EFS) for use with your self hosted stack. Note that while we provide instructions for manually setting this up, this is best deployed as part of a cloudformation stack. Please contact us for assistance or for cloudformation template examples.

  1. Create an Application Load Balancer.
  2. Copy the Public DNS of the load balancer. It will be used in the steps to follow.
  3. Create instance from desired AMI by following the steps in Launching an instance and Setting up an instance.
  4. Create your Security Groups.
  5. Create your EFS File System.
  6. Mount the file system on the EC2 instance.
  7. Modify the /etc/fstab configuration file.
  8. Modify the permissions on the directory:
chown ec2-user:ec2-user /mnt/efs
chmod 777 /mnt/efs
  1. When running the docker container, use -v to bind the mounted directory to /opt/datalogics/public.
    For example: -v /mnt/efs:/opt/datalogics/public

Setting up infrastructure for scaling and load balancing

Follow these instructions to manually set up autobalanced load scaling infrastructure for use with your self hosted stack. Note that while we provide instructions for manually setting this up, this is best deployed as part of a cloudformation stack. Please contact us for assistance or for cloudformation template examples.

  1. Create a new AMI Snapshot from the EC2 dashboard.
  2. Create a new launch template.
  3. Create a new target group.
  4. Create a new autoscaling group.
  5. Add a load balancer to your autoscaling group.
  6. Create new listener rules.
  7. Create new HTTPS listener rules.
  8. Create new security group rules.