AWS Step Functions
Developer Guide

Step Functions Local Configuration Options

To use Step Functions Local by starting the jar file, you can set configuration options by either setting them with the AWS CLI, or by including them in the system environment. For Docker, you must specify these options in a file that you reference when starting Step Functions Local.

Configuration Options

Option Command Line Environment
Account -account,--aws-account AWS_ACCOUNT_ID
Region -region,--aws-region AWS_DEFAULT_REGION
Wait Time Scale -waitTimeScale,--wait-time-scale WAIT_TIME_SCALE
Lambda Endpoint -lambdaEndpoint,--lambda-endpoint LAMBDA_ENDPOINT
Batch Endpoint -batchEndpoint,--batch-endpoint BATCH_ENDPOINT
DynamoDB Endpoint -dynamoDBEndpoint,--dynamodb-endpoint DYNAMODB_ENDPOINT
ECS Endpoint -ecsEndpoint,--ecs-endpoint ECS_ENDPOINT
Glue Endpoint -glueEndpoint,--glue-endpoint GLUE_ENDPOINT
SageMaker Endpoint -sageMakerEndpoint,--sagemaker-endpoint SAGE_MAKER_ENDPOINT
SQS Endpoint -sqsEndpoint,--sqs-endpoint SQS_ENDPOINT
SNS Endpoint -snsEndpoint,--sns-endpoint SNS_ENDPOINT

Credentials and Configuration for Docker

To configure Step Functions Local for Docker, create a file: aws-stepfunctions-local-credentials.txt.

This file contains your credentials and other configuration options, such as:

AWS_DEFAULT_REGION=AWS_REGION_OF_YOUR_AWS_RESOURCES AWS_ACCESS_KEY_ID=YOUR_AWS_ACCESS_KEY AWS_SECRET_ACCESS_KEY=YOUR_AWS_SECRET_KEY WAIT_TIME_SCALE=VALUE LAMBDA_ENDPOINT=VALUE BATCH_ENDPOINT=VALUE DYNAMODB_ENDPOINT=VALUE ECS_ENDPOINT=VALUE GLUE_ENDPOINT=VALUE SAGE_MAKER_ENDPOINT=VALUE SQS_ENDPOINT=VALUE SNS_ENDPOINT=VALUE

Once you have configured your credentials and configuration options in aws-stepfunctions-local-credentials.txt, start Step Functions with the following command:

docker run -p 8083:8083 --env-file aws-stepfunctions-local-credentials.txt amazon/aws-stepfunctions-local