Download Latest Version v4.6.0 source code.tar.gz (10.9 MB)
Email in envelope

Get an email when there's a new version of LocalStack

Home / v4.6.0
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2025-07-03 19.3 kB
v4.6.0 source code.tar.gz 2025-07-03 10.9 MB
v4.6.0 source code.zip 2025-07-03 12.8 MB
Totals: 3 Items   23.7 MB 1

Summary

LocalStack 4.6 is now available! This release introduces AWS CodeArtifact support for package management, Kubernetes execution for Glue jobs, dramatically improved AppSync JavaScript resolver performance, API Gateway HTTP API SQS integrations, and enhancements across S3, CloudFront, CodeBuild, and EventBridge Pipes providers.

AWS Features

  • LocalStack now supports AWS CodeArtifact, enabling you to mock creating domains, repositories, external connections, and authorization tokens, with additional support for NPM repositories, enabling you to publish and install packages locally. Refer to our documentation to learn more. (๐ŸŒŸ base)

Enhancements

  • LocalStack now includes Kubernetes support for AWS Glue job execution, enabling you to run them as pods in your Kubernetes cluster. To activate the Kubernetes executor, set the GLUE_JOB_EXECUTOR_PROVIDER environment variable to v2, and set the CONTAINER_RUNTIME environment variable to kubernetes. (๐ŸŒŸ enterprise)
  • LocalStack has significantly improved the performance and capabilities of AWS AppSync JavaScript resolvers. The JavaScript resolver executor has been overhauled to replace the previous Docker container-based implementation with a lightweight Node.js runtime package. (๐ŸŒŸ ultimate)
  • AppSync provider now includes the following enhancements: (๐ŸŒŸ ultimate)
    • AppSync now supports console.log statements in resolver code, with the output directed to LocalStack logs for improved debugging capabilities.
    • Support for attributeExists conditions in the RDS statement where clause logic.
    • Enhanced JavaScript resolver utility functions, including support for util.error and util.unauthorized methods, with improved util.appendError functionality.
  • CodeBuild provider now includes the following enhancements: (๐ŸŒŸ base)
    • Buildspec overrides now follow the correct precedence. Buildspecs from CreateProject and StartBuild take priority over those in the source code. Buildspec overrides from CodePipeline actions are supported and passed to StartBuild.
    • CRUD support for source credentials is now available: ImportSourceCredentials, ListSourceCredentials, and DeleteSourceCredentials .
    • You can use custom Docker images by setting the CODEBUILD_ENABLE_CUSTOM_IMAGES environment variable. This allows any build image, not just Amazon Linux 2023 containers. Official AWS CodeBuild Docker images from GitHub are also supported.
    • Environment variables now support Secrets Manager and SSM parameters as well as plaintext variables. Variable precedence is handled correctly (StartBuild > CreateProject > buildspec), and parameter overrides now update values instead of fully replacing them during builds.
  • API Gateway HTTP API provider now includes support for AWS_PROXY SQS subtypes (first-class integrations), enabling direct SQS operations through HTTP API endpoints. The supported operations include: (๐ŸŒŸ base)
  • Support for AWS S3 MetricsConfiguration APIs, enabling management of CloudWatch request metrics configurations for S3 buckets. The supported operations include:
  • EventBridge Pipes provider now supports pipe configuration updates through the UpdatePipe operation. You can now modify: (๐ŸŒŸ ultimate)
    • Pipe targets
    • Target parameters
    • Enrichment configurations This is in addition to the previously supported source parameters.
  • API Gateway provider now supports:
    • Support for the UpdateMethodResponse API.
    • CRUD operations for WebSockets route and integration request parameters through enhanced CreateRoute and CreateIntegration validation logic. (๐ŸŒŸ base)
    • DeleteRouteRequestParameter operation, enabling complete lifecycle management of WebSocket route configurations and proper parameter handling in the invocation layer. (๐ŸŒŸ base)
    • Improved VTL $input.path and $input.json handling, fixing edge cases for empty request bodies, non-existent JSONPath values, non-JSON content, and string body fallback behavior for better parity with AWS.
  • S3 provider now includes the following enhancements:
    • DeleteObject now checks IfMatch headers correctly. It returns errors for IfMatch on regular buckets, since this is only supported in Directory Buckets, and adds clear logs.
    • Object Lock compliance is improved. Retention Mode values are validated, and COMPLIANCE mode restrictions are enforced when updating retention with PutObjectRetention.
    • Improved Checksum handling in UploadPartCopy with checksums now calculated and returned correctly during multipart copy in multipart uploads.
    • GetObjectAttributes now fully implements ObjectParts. It supports both COMPOSITE and FULL_OBJECT checksums for multipart uploads and stores and retrieves part metadata correctly.
  • CloudFront provider now supports custom distribution IDs through the _custom_id_ tag, enabling predictable distribution URLs. Refer to our documentation to learn more. (๐ŸŒŸ base)
  • EFS provider now supports the following new API operations: (๐ŸŒŸ ultimate)
  • Support for Airflow version 2.10.3 in the MWAA environment. (๐ŸŒŸ ultimate)
  • Timestream provider now supports tagging for databases and tables. (๐ŸŒŸ ultimate)
  • Improved RDS statement where clause logic to handle nested and/or operators. (๐ŸŒŸ base)
  • KMS provider now supports the ReEncrypt operation.
  • EKS provider now supports the DescribeClusterVersions operation. (๐ŸŒŸ ultimate)
  • DocumentDB provider now supports MongoDB transactions by starting clusters in single-node replica mode to enhance parity with transactional operations on AWS. (๐ŸŒŸ ultimate)
  • CloudTrail provider now populates the imageId parameter in requestParameters for ec2.ModifyImageAttribute API calls. (๐ŸŒŸ ultimate)
  • Route53 provider now supports alias records targeting dualstack ELB domains (e.g., dualstack.<elb-id>.elb.amazonaws.com). (๐ŸŒŸ base)
  • RDS provider now allows using postgres as a username when creating PostgreSQL databases, in parity with AWS. (๐ŸŒŸ base)
  • SQS provider now automatically propagates X-Amzn-Trace-Id headers from incoming requests to the AWSTraceHeader message attribute, enabling X-Ray tracing integration for SQS messages.
  • Cognito provider now properly includes the nonce parameter from authorization requests as a claim in generated OIDC tokens. (๐ŸŒŸ base)
  • Step Functions provider now supports mocking for the StartSyncExecution operation to enable consistent testing across both Standard and Express state machines.
  • ELBv2 provider now supports the ForwardConfig configuration block in listener rules, enabling compatibility with AWS Load Balancer Controller for Kubernetes by properly handling target group configurations. (๐ŸŒŸ base)

LocalStack Features

  • LocalStack now includes x-localstack header in all AWS service responses to help distinguish between LocalStack and AWS origins during development and testing. Set the LOCALSTACK_RESPONSE_HEADER_ENABLED environment variable to false to disable this.
  • LocalStackโ€™s state export functionality now supports efficient transfer of large state files up to 1GB with improved connection stability. (๐ŸŒŸ base)
  • Support for configurable timeout settings for Kubernetes resource readiness checks. The default 30-second timeout can now be customized through environment variables, such as:
    • K8S_WAIT_FOR_POD_READY_TIMEOUT: Sets the wait time for Kubernetes pod startup
    • K8S_WAIT_FOR_DEPLOYMENT_READY_TIMEOUT: Sets the wait time for Kubernetes deployment rollout
    • K8S_WAIT_FOR_SERVICE_READY_TIMEOUT: Sets the wait time for Kubernetes service readiness

What's Changed

Exciting New Features ๐ŸŽ‰

Other Changes

New Contributors

Full Changelog: https://github.com/localstack/localstack/compare/v4.5.0...v4.6.0

Source: README.md, updated 2025-07-03