awslabs · sebsto · May 28, 2026 · May 14, 2026 · May 14, 2026 · May 14, 2026
diff --git a/.github/workflows/scripts/check-archive-plugin.sh b/.github/workflows/scripts/check-archive-plugin.sh
@@ -29,7 +29,7 @@ ZIP_FILE=${OUTPUT_DIR}/MyLambda/MyLambda.zip
 pushd "Examples/${EXAMPLE}" || exit 1
 
 # package the example (docker and swift toolchain are installed on the GH runner)
-LAMBDA_USE_LOCAL_DEPS=../.. swift package archive --allow-network-connections docker || exit 1
+LAMBDA_USE_LOCAL_DEPS=../.. swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023 || exit 1
 
 # did the plugin generated a Linux binary?
 [ -f "${OUTPUT_FILE}" ]

diff --git a/Examples/APIGatewayV1/README.md b/Examples/APIGatewayV1/README.md
@@ -25,7 +25,7 @@ To build the package, type the following commands.
 
 ```bash
 swift build
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy. 

diff --git a/Examples/APIGatewayV1/template.yaml b/Examples/APIGatewayV1/template.yaml
@@ -26,7 +26,7 @@ Resources:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/APIGatewayLambda/APIGatewayLambda.zip
       Timeout: 60
       Handler: swift.bootstrap  # ignored by the Swift runtime
-      Runtime: provided.al2
+      Runtime: provided.al2023
       MemorySize: 128
       Architectures:
         - arm64

diff --git a/Examples/APIGatewayV2+LambdaAuthorizer/README.md b/Examples/APIGatewayV2+LambdaAuthorizer/README.md
@@ -19,7 +19,7 @@ To build the package, type the following commands.
 
 ```bash
 swift build
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there are two ZIP files ready to deploy, one for the authorizer function and one for the business function.

diff --git a/Examples/APIGatewayV2+LambdaAuthorizer/template.yaml b/Examples/APIGatewayV2+LambdaAuthorizer/template.yaml
@@ -50,7 +50,7 @@ Resources:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/APIGatewayLambda/APIGatewayLambda.zip
       Timeout: 60
       Handler: swift.bootstrap  # ignored by the Swift runtime
-      Runtime: provided.al2
+      Runtime: provided.al2023
       MemorySize: 128
       Architectures:
         - arm64
@@ -75,7 +75,7 @@ Resources:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/AuthorizerLambda/AuthorizerLambda.zip
       Timeout: 29  # max 29 seconds for Lambda authorizers
       Handler: swift.bootstrap  # ignored by the Swift runtime
-      Runtime: provided.al2
+      Runtime: provided.al2023
       MemorySize: 128
       Architectures:
         - arm64

diff --git a/Examples/APIGatewayV2/README.md b/Examples/APIGatewayV2/README.md
@@ -25,7 +25,7 @@ To build the package, type the following commands.
 
 ```bash
 swift build
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy. 

diff --git a/Examples/APIGatewayV2/template.yaml b/Examples/APIGatewayV2/template.yaml
@@ -26,7 +26,7 @@ Resources:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/APIGatewayLambda/APIGatewayLambda.zip
       Timeout: 60
       Handler: swift.bootstrap  # ignored by the Swift runtime
-      Runtime: provided.al2
+      Runtime: provided.al2023
       MemorySize: 128
       Architectures:
         - arm64

diff --git a/Examples/BackgroundTasks/README.md b/Examples/BackgroundTasks/README.md
@@ -25,7 +25,7 @@ Once the struct is created and the `handle(...)` method is defined, the sample c
 To build & archive the package, type the following commands.
 
 ```bash
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy. 
@@ -42,7 +42,7 @@ AWS_ACCOUNT_ID=012345678901
 aws lambda create-function \
 --function-name BackgroundTasks \
 --zip-file fileb://.build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/BackgroundTasks/BackgroundTasks.zip \
---runtime provided.al2 \
+--runtime provided.al2023 \
 --handler provided  \
 --architectures arm64 \
 --role arn:aws:iam::${AWS_ACCOUNT_ID}:role/lambda_basic_execution \

diff --git a/Examples/CDK/README.md b/Examples/CDK/README.md
@@ -12,7 +12,7 @@ To build the package, type the following commands.
 
 ```bash
 swift build
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy. 

diff --git a/Examples/HelloJSON/README.md b/Examples/HelloJSON/README.md
@@ -21,7 +21,7 @@ The function return value will be encoded to a `HelloResponse` as your Lambda fu
 To build & archive the package, type the following commands.
 
 ```bash
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy. 
@@ -38,7 +38,7 @@ AWS_ACCOUNT_ID=012345678901
 aws lambda create-function \
 --function-name HelloJSON \
 --zip-file fileb://.build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/HelloJSON/HelloJSON.zip \
---runtime provided.al2 \
+--runtime provided.al2023 \
 --handler provided  \
 --architectures arm64 \
 --role arn:aws:iam::${AWS_ACCOUNT_ID}:role/lambda_basic_execution

diff --git a/Examples/HelloWorld/README.md b/Examples/HelloWorld/README.md
@@ -47,7 +47,7 @@ To build & archive the package, type the following commands.
 
 ```bash
 swift build
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy. 
@@ -61,7 +61,7 @@ Here is how to deploy using the `aws` command line.
 aws lambda create-function \
 --function-name MyLambda \
 --zip-file fileb://.build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/MyLambda/MyLambda.zip \
---runtime provided.al2 \
+--runtime provided.al2023 \
 --handler provided  \
 --architectures arm64 \
 --role arn:aws:iam::<YOUR_ACCOUNT_ID>:role/lambda_basic_execution

diff --git a/Examples/HelloWorldNoTraits/README.md b/Examples/HelloWorldNoTraits/README.md
@@ -53,7 +53,7 @@ To build & archive the package, type the following commands.
 
 ```bash
 swift build
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy. 
@@ -67,7 +67,7 @@ Here is how to deploy using the `aws` command line.
 aws lambda create-function \
 --function-name MyLambda \
 --zip-file fileb://.build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/MyLambda/MyLambda.zip \
---runtime provided.al2 \
+--runtime provided.al2023 \
 --handler provided  \
 --architectures arm64 \
 --role arn:aws:iam::<YOUR_ACCOUNT_ID>:role/lambda_basic_execution

diff --git a/Examples/HummingbirdLambda/README.md b/Examples/HummingbirdLambda/README.md
@@ -18,7 +18,7 @@ To build the package, type the following commands.
 
 ```bash
 swift build
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy. 

diff --git a/Examples/HummingbirdLambda/template.yaml b/Examples/HummingbirdLambda/template.yaml
@@ -26,7 +26,7 @@ Resources:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/HBLambda/HBLambda.zip
       Timeout: 60
       Handler: swift.bootstrap  # ignored by the Swift runtime
-      Runtime: provided.al2
+      Runtime: provided.al2023
       MemorySize: 128
       Architectures:
         - arm64

diff --git a/Examples/JSONLogging/README.md b/Examples/JSONLogging/README.md
@@ -84,7 +84,7 @@ AWS_LAMBDA_LOG_FORMAT=JSON swift run
 
 ```bash
 swift build
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 The deployment package will be at:

diff --git a/Examples/ManagedInstances/README.md b/Examples/ManagedInstances/README.md
@@ -28,7 +28,7 @@ arn:aws:lambda:us-west-2:486652066693:capacity-provider:TestEC2
 
 ```bash
 # Build and package the Swift Lambda function
-swift package archive --allow-network-connections docker 
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 
 # Change the values below to match your setup 
 REGION=us-west-2

diff --git a/Examples/MultiSourceAPI/README.md b/Examples/MultiSourceAPI/README.md
@@ -13,7 +13,7 @@ Based on the successfully decoded type, it returns an appropriate response.
 ## Building
 
 ```bash
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 ## Deploying

diff --git a/Examples/MultiSourceAPI/template.yaml b/Examples/MultiSourceAPI/template.yaml
@@ -8,7 +8,7 @@ Resources:
     Properties:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/MultiSourceAPI/MultiSourceAPI.zip
       Handler: provided
-      Runtime: provided.al2
+      Runtime: provided.al2023
       Architectures:
         - arm64
       MemorySize: 256

diff --git a/Examples/MultiTenant/README.md b/Examples/MultiTenant/README.md
@@ -166,7 +166,7 @@ requestParameters:
 
 1. **Build the Lambda function**:
    ```bash
-   swift package archive --allow-network-connections docker
+   swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
    ```
 
 2. **Deploy using SAM**:

diff --git a/Examples/ResourcesPackaging/README.md b/Examples/ResourcesPackaging/README.md
@@ -49,7 +49,7 @@ curl -d '"hello"' http://127.0.0.1:7000/invoke
 To build & archive the package, type the following commands.
 
 ```bash
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy. 
@@ -63,7 +63,7 @@ Here is how to deploy using the `aws` command line.
 aws lambda create-function \
 --function-name MyLambda \
 --zip-file fileb://.build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/MyLambda/MyLambda.zip \
---runtime provided.al2 \
+--runtime provided.al2023 \
 --handler provided  \
 --architectures arm64 \
 --role arn:aws:iam::<YOUR_ACCOUNT_ID>:role/lambda_basic_execution

diff --git a/Examples/S3EventNotifier/README.md b/Examples/S3EventNotifier/README.md
@@ -23,7 +23,7 @@ To build & archive the package you can use the following commands:
 
 ```bash
 swift build
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there are no errors, a ZIP file should be ready to deploy, located at `.build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/S3EventNotifier/S3EventNotifier.zip`.
@@ -41,7 +41,7 @@ aws lambda create-function \
     --region "${REGION}" \
     --function-name S3EventNotifier \
     --zip-file fileb://.build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/S3EventNotifier/S3EventNotifier.zip \
-    --runtime provided.al2 \
+    --runtime provided.al2023 \
     --handler provided  \
     --architectures arm64 \
     --role arn:aws:iam::<YOUR_ACCOUNT_ID>:role/lambda_basic_execution

diff --git a/Examples/S3_AWSSDK/README.md b/Examples/S3_AWSSDK/README.md
@@ -25,7 +25,7 @@ To build the package, type the following commands.
 
 ```bash
 swift build
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy. 

diff --git a/Examples/S3_AWSSDK/template.yaml b/Examples/S3_AWSSDK/template.yaml
@@ -26,7 +26,7 @@ Resources:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/AWSSDKExample/AWSSDKExample.zip
       Timeout: 60
       Handler: swift.bootstrap  # ignored by the Swift runtime
-      Runtime: provided.al2
+      Runtime: provided.al2023
       MemorySize: 128
       Architectures:
         - arm64

diff --git a/Examples/S3_Soto/README.md b/Examples/S3_Soto/README.md
@@ -25,7 +25,7 @@ To build the package, type the following command.
 
 ```bash
 swift build
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy. 

diff --git a/Examples/S3_Soto/template.yaml b/Examples/S3_Soto/template.yaml
@@ -26,7 +26,7 @@ Resources:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/SotoExample/SotoExample.zip
       Timeout: 60
       Handler: swift.bootstrap  # ignored by the Swift runtime
-      Runtime: provided.al2
+      Runtime: provided.al2023
       MemorySize: 128
       Architectures:
         - arm64

diff --git a/Examples/ServiceLifecycle+Postgres/INFRASTRUCTURE.md b/Examples/ServiceLifecycle+Postgres/INFRASTRUCTURE.md
@@ -54,7 +54,7 @@ The infrastructure consists of a secure VPC setup with private subnets only, con
 ## Lambda Function Configuration
 
 ### Service Lifecycle Lambda
-- **Runtime**: Custom runtime (provided.al2)
+- **Runtime**: Custom runtime (provided.al2023)
 - **Architecture**: ARM64
 - **Memory**: 128MB
 - **Timeout**: 60 seconds

diff --git a/Examples/ServiceLifecycle+Postgres/README.md b/Examples/ServiceLifecycle+Postgres/README.md
@@ -80,7 +80,7 @@ The Lambda function uses the following environment variables for database connec
 
 1. **Build the Lambda function:**
    ```bash
-   swift package archive --allow-network-connections docker
+   swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
    ```
 
 2. **Deploy with SAM:**

diff --git a/Examples/ServiceLifecycle+Postgres/template.yaml b/Examples/ServiceLifecycle+Postgres/template.yaml
@@ -158,7 +158,7 @@ Resources:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/LambdaWithServiceLifecycle/LambdaWithServiceLifecycle.zip
       Timeout: 60
       Handler: swift.bootstrap  # ignored by the Swift runtime
-      Runtime: provided.al2
+      Runtime: provided.al2023
       MemorySize: 128
       Architectures:
         - arm64

diff --git a/Examples/Streaming+APIGateway/README.md b/Examples/Streaming+APIGateway/README.md
@@ -66,7 +66,7 @@ Once the struct is created and the `handle(...)` method is defined, the sample c
 To build & archive the package, type the following commands.
 
 ```bash
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy. 
@@ -111,7 +111,7 @@ Resources:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/StreamingNumbers/StreamingNumbers.zip
       Timeout: 60  # Must be bigger than the time it takes to stream the output
       Handler: swift.bootstrap
-      Runtime: provided.al2
+      Runtime: provided.al2023
       MemorySize: 128
       Architectures:
         - arm64

diff --git a/Examples/Streaming+APIGateway/template.yaml b/Examples/Streaming+APIGateway/template.yaml
@@ -26,7 +26,7 @@ Resources:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/StreamingNumbers/StreamingNumbers.zip
       Timeout: 60  # Must be bigger than the time it takes to stream the output
       Handler: swift.bootstrap  # ignored by the Swift runtime
-      Runtime: provided.al2
+      Runtime: provided.al2023
       MemorySize: 128
       Architectures:
         - arm64

diff --git a/Examples/Streaming+Codable/README.md b/Examples/Streaming+Codable/README.md
@@ -78,7 +78,7 @@ Key features demonstrated:
 To build & archive the package, type the following commands.
 
 ```bash
-swift package archive --allow-network-connections docker
+swift package archive --allow-network-connections docker --base-docker-image swift:amazonlinux2023
 ```
 
 If there is no error, there is a ZIP file ready to deploy.
@@ -119,7 +119,7 @@ AWS_ACCOUNT_ID=012345678901
 aws lambda create-function \
 --function-name StreamingFromEvent \
 --zip-file fileb://.build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/StreamingFromEvent/StreamingFromEvent.zip \
---runtime provided.al2 \
+--runtime provided.al2023 \
 --handler provided \
 --architectures arm64 \
 --role arn:aws:iam::${AWS_ACCOUNT_ID}:role/lambda_basic_execution
@@ -231,7 +231,7 @@ Resources:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/StreamingFromEvent/StreamingFromEvent.zip
       Timeout: 15
       Handler: swift.bootstrap  # ignored by the Swift runtime
-      Runtime: provided.al2
+      Runtime: provided.al2023
       MemorySize: 128
       Architectures:
         - arm64

diff --git a/Examples/Streaming+Codable/template.yaml b/Examples/Streaming+Codable/template.yaml
@@ -26,7 +26,7 @@ Resources:
       CodeUri: .build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/StreamingCodable/StreamingCodable.zip
       Timeout: 15
       Handler: swift.bootstrap  # ignored by the Swift runtime
-      Runtime: provided.al2
+      Runtime: provided.al2023
       MemorySize: 128
       Architectures:
         - arm64