How to Run & Deploy IronPDF .NET on AWS Lambda

1. Create AWS Lambda with a container template (.NET 5)
Please refer to the first part of this official document from AWS: .NET 5 AWS Lambda Support with Container Images.
2. Add package dependencies
These dependencies are required for Chrome in this AWS environment.
Please modify the Docker file according to these instructions:
AWS Lambda with .NET 5
AWS Lambda with .NET 7
AWS Lambda with .NET 8
3. Add the IronPDF (Linux) NuGet package
Install IronPdf.Linux
- In Solution Explorer, right-click References, Manage NuGet Packages.
- Select Browse and search
IronPdf.Linux
. - Select the package and install.
4. Modify FunctionHandler code
This example will create a PDF file from a webpage https://ironpdf.com/ and save it to /tmp
. To view this PDF, you must upload it to another service such as S3.
It is necessary to configure the temporary folder when using IronPDF on AWS Lambda. Please use the TempFolderPath and CustomDeploymentDirectory properties to do this.
public Casing FunctionHandler(string input, ILambdaContext context)
{
try
{
context.Logger.LogLine($"START FunctionHandler RequestId: {context.AwsRequestId} Input: {input}");
var awsTmpPath = @"/tmp/"; // AWS temporary storage location
// [Optional] Enable logging for debugging
// Uncomment these lines if you encounter issues
// IronPdf.Logging.Logger.EnableDebugging = true;
// IronPdf.Logging.Logger.LogFilePath = awsTmpPath;
// IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;
// Set your IronPDF license key
IronPdf.License.LicenseKey = "YOUR_LICENSE_KEY";
// Disable GPU for Chrome rendering in headless environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
// Configure IronPDF to use the AWS temporary directory
IronPdf.Installation.TempFolderPath = awsTmpPath;
IronPdf.Installation.CustomDeploymentDirectory = awsTmpPath;
// Automatically configure Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
context.Logger.LogLine($"Creating IronPdf.ChromePdfRenderer");
var Renderer = new IronPdf.ChromePdfRenderer();
context.Logger.LogLine($"Rendering PDF");
using var pdfDoc = Renderer.RenderUrlAsPdf("https://ironpdf.com/");
var guid = Guid.NewGuid();
var fileName = $"/tmp/{input}_{guid}.pdf"; // Save file to /tmp
context.Logger.LogLine($"Saving PDF with name: {fileName}");
pdfDoc.SaveAs(fileName);
// Place for future code to upload the PDF file to a service like AWS S3.
context.Logger.LogLine($"COMPLETE!");
}
catch (Exception e)
{
context.Logger.LogLine($"[ERROR] FunctionHandler : {e.Message}");
}
return new Casing(input?.ToLower(), input?.ToUpper());
}
public Casing FunctionHandler(string input, ILambdaContext context)
{
try
{
context.Logger.LogLine($"START FunctionHandler RequestId: {context.AwsRequestId} Input: {input}");
var awsTmpPath = @"/tmp/"; // AWS temporary storage location
// [Optional] Enable logging for debugging
// Uncomment these lines if you encounter issues
// IronPdf.Logging.Logger.EnableDebugging = true;
// IronPdf.Logging.Logger.LogFilePath = awsTmpPath;
// IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;
// Set your IronPDF license key
IronPdf.License.LicenseKey = "YOUR_LICENSE_KEY";
// Disable GPU for Chrome rendering in headless environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
// Configure IronPDF to use the AWS temporary directory
IronPdf.Installation.TempFolderPath = awsTmpPath;
IronPdf.Installation.CustomDeploymentDirectory = awsTmpPath;
// Automatically configure Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
context.Logger.LogLine($"Creating IronPdf.ChromePdfRenderer");
var Renderer = new IronPdf.ChromePdfRenderer();
context.Logger.LogLine($"Rendering PDF");
using var pdfDoc = Renderer.RenderUrlAsPdf("https://ironpdf.com/");
var guid = Guid.NewGuid();
var fileName = $"/tmp/{input}_{guid}.pdf"; // Save file to /tmp
context.Logger.LogLine($"Saving PDF with name: {fileName}");
pdfDoc.SaveAs(fileName);
// Place for future code to upload the PDF file to a service like AWS S3.
context.Logger.LogLine($"COMPLETE!");
}
catch (Exception e)
{
context.Logger.LogLine($"[ERROR] FunctionHandler : {e.Message}");
}
return new Casing(input?.ToLower(), input?.ToUpper());
}
Public Function FunctionHandler(ByVal input As String, ByVal context As ILambdaContext) As Casing
Try
context.Logger.LogLine($"START FunctionHandler RequestId: {context.AwsRequestId} Input: {input}")
Dim awsTmpPath = "/tmp/" ' AWS temporary storage location
' [Optional] Enable logging for debugging
' Uncomment these lines if you encounter issues
' IronPdf.Logging.Logger.EnableDebugging = true;
' IronPdf.Logging.Logger.LogFilePath = awsTmpPath;
' IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;
' Set your IronPDF license key
IronPdf.License.LicenseKey = "YOUR_LICENSE_KEY"
' Disable GPU for Chrome rendering in headless environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
' Configure IronPDF to use the AWS temporary directory
IronPdf.Installation.TempFolderPath = awsTmpPath
IronPdf.Installation.CustomDeploymentDirectory = awsTmpPath
' Automatically configure Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True
context.Logger.LogLine($"Creating IronPdf.ChromePdfRenderer")
Dim Renderer = New IronPdf.ChromePdfRenderer()
context.Logger.LogLine($"Rendering PDF")
Dim pdfDoc = Renderer.RenderUrlAsPdf("https://ironpdf.com/")
Dim guid As System.Guid = System.Guid.NewGuid()
Dim fileName = $"/tmp/{input}_{guid}.pdf" ' Save file to /tmp
context.Logger.LogLine($"Saving PDF with name: {fileName}")
pdfDoc.SaveAs(fileName)
' Place for future code to upload the PDF file to a service like AWS S3.
context.Logger.LogLine($"COMPLETE!")
Catch e As Exception
context.Logger.LogLine($"[ERROR] FunctionHandler : {e.Message}")
End Try
Return New Casing(input?.ToLower(), input?.ToUpper())
End Function
5. Increase Memory and Timeout
IronPDF requires more time and memory than the default value of Lambda. You can configure it in aws-lambda-tools-defaults.json
. Please adjust this to match your function. In this example, we will set it to 512 (MB) and 330 (seconds).
{
"function-memory-size": 512,
"function-timeout": 330
}
You also can update this configuration using the Lambda console. Navigate to the Configuring AWS Lambda functions article for more information.
6. Publish
Please follow the instructions in the latter part of the '.NET 5 AWS Lambda Support with Container Images' document to publish and test your Lambda function.
7. Try it out!
You can activate the Lambda function using the Lambda console or via Visual Studio by using the AWS Toolkit for Visual Studio.
Frequently Asked Questions
How do I create a PDF from a URL using a .NET AWS Lambda function?
To create a PDF from a URL in a .NET AWS Lambda function, use IronPDF's ChromePdfRenderer.RenderUrlAsPdf
method. Ensure the temporary folder is configured using TempFolderPath
and CustomDeploymentDirectory
properties.
What steps should I take to configure IronPDF on AWS Lambda?
Configure IronPDF on AWS Lambda by setting the temporary folder paths using TempFolderPath
and CustomDeploymentDirectory
, disabling GPU with ChromeGpuModes.Disabled
, and enabling automatic configuration of Linux and Docker dependencies with LinuxAndDockerDependenciesAutoConfig
set to true.
Why is it important to adjust memory and timeout settings for AWS Lambda?
Adjusting memory and timeout settings for AWS Lambda is crucial because IronPDF requires more resources than the default settings. This can be configured in aws-lambda-tools-defaults.json
or through the AWS Lambda console.
How do I ensure Chrome dependencies are correctly installed for AWS Lambda?
Ensure Chrome dependencies are correctly installed by modifying the Dockerfile according to the instructions specific to your .NET version, as provided in the article. This includes installing necessary Linux packages for Chrome in the AWS environment.
Can I use Visual Studio to activate and test my AWS Lambda function?
Yes, you can use Visual Studio to activate and test your AWS Lambda function by using the AWS Toolkit for Visual Studio, which allows seamless deployment and testing directly from the IDE.
What is the significance of using a container template for .NET 5 on AWS Lambda?
Using a container template for .NET 5 on AWS Lambda is significant because it facilitates the deployment of applications with their dependencies, such as IronPDF, ensuring consistency across environments.
How can I handle exceptions in my AWS Lambda function using IronPDF?
Handle exceptions in your AWS Lambda function by wrapping your IronPDF operations in a try-catch block, logging errors using context.Logger.LogLine
for debugging and troubleshooting.