Registry / devops / serverless-v3-aws-lambda-runtime-schema-override

serverless-v3-aws-lambda-runtime-schema-override

library1.0.0jsnpmunverified

A Serverless Framework v3 plugin that overrides the default AWS Lambda runtime schema, allowing users to continue using newer or custom runtimes with Serverless v3 (which is unmaintained). Current stable version: 1.0.0. The plugin bakes in recent runtimes and supports manual override via custom.awsLambdaRuntimeSchemaOverride. Unlike workarounds that disable config validation, this plugin preserves configValidationMode: error. Note: sls invoke local is not affected.

devops

npm install serverless-v3-aws-lambda-runtime-schema-override

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SERVERLESS-V3-AWS-

serverless-v3-aws-lambda-runtime-schema-override

devopsjavascriptv1.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

plugin (via serverless.yml plugins array)

✓ plugins: - serverless-v3-aws-lambda-runtime-schema-override

✗ plugins: - serverless-v3-aws-lambda-runtime-schema-override.js

Plugin is loaded automatically by Serverless Framework; no JavaScript import required. The plugin must be listed in serverless.yml plugins section.

custom.awsLambdaRuntimeSchemaOverride configuration

✓ custom: awsLambdaRuntimeSchemaOverride: - nodejs20.x - python3.12

✗ custom: awsLambdaRuntimeSchemaOverride: - nodejs20.x - python3.12 - unsupported-runtime

Only valid AWS Lambda runtimes should be listed; invalid runtimes may cause schema validation errors.

npm install

✓ npm install --save-dev serverless-v3-aws-lambda-runtime-schema-override

✗ npm install serverless-v3-aws-lambda-runtime-schema-override (without --save-dev if not production dependency)

Best practice to install as dev dependency since it's only used during deployment.

Shows installation, plugin registration, and optional runtime override in serverless.yml.

# Install plugin npm install --save-dev serverless-v3-aws-lambda-runtime-schema-override # Add to serverless.yml plugins: - serverless-v3-aws-lambda-runtime-schema-override # Optionally override runtimes custom: awsLambdaRuntimeSchemaOverride: - nodejs20.x - python3.12 # Deploy as usual serverless deploy

Debug

Known issues

gotchasls invoke local does not respect custom runtimes — local invocation uses a separate baked-in list.

fix

Use sls invoke (remote) for custom runtimes, or update Serverless Framework manually for local invocations.

affects: >=1.0.0

gotchaPlugin requires Serverless Framework v3.38 or higher; incompatible with v2 or v4.

fix

Ensure serverless version satisfies peer dependency (^3.38). Use npx serverless --version to check.

affects: >=1.0.0

deprecatedServerless Framework v3 is unmaintained — plugin only works with v3. Plan migration to v4.

fix

Migrate to Serverless Framework v4 and find equivalent runtime override solution.

affects: >=1.0.0

gotchaProviding an unsupported runtime in awsLambdaRuntimeSchemaOverride may cause deployment failures.

fix

Only use runtimes officially supported by AWS Lambda. See AWS documentation for current list.

affects: >=1.0.0

gotchaPlugin only overrides the provider schema validation; actual Lambda function creation still requires supported runtimes on AWS side.

fix

Ensure the runtime you specify is actually supported by AWS Lambda in your region.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Configuration error: Unsupported runtime: nodejs20.x

Serverless v3 schema doesn't include newer runtimes by default (v3 unmaintained).

fix

Install and configure this plugin to override the schema.

Error: Serverless plugin "serverless-v3-aws-lambda-runtime-schema-override" not found

Plugin not installed in the project's node_modules.

fix

Run npm install --save-dev serverless-v3-aws-lambda-runtime-schema-override

TypeError: Cannot read properties of undefined (reading 'awsLambdaRuntimeSchemaOverride')

Plugin version mismatch or serverless version below 3.38.

fix

Update Serverless Framework to ^3.38 and ensure plugin is listed in plugins array.

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

serverlessrequiredPeer dependency: requires Serverless Framework v3.38 or higher

Agent activity

9 hits · last 30 days

node

Resources

githubhttps://github.com/FinchPowers/serverless-v3-aws-lambda-runtime-schema-override ↗

packageserverless-v3-aws-lambda-runtime-schema-override ↗

homepagehttps://github.com/FinchPowers/serverless-v3-aws-lambda-runtime-schema-override#readme ↗