Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Troubleshooting the Amazon Serverless Application Repository

When you use the Amazon Serverless Application Repository, you might encounter issues when you create, update, or delete your applications. Use this section to help troubleshoot common issues that you might encounter. You can also search for answers and post questions in the Amazon Serverless Application Repository forums.

You Can't Make an Application Public

If you can't make your application public, you might be missing a license file for your application that is approved by the Open Source Initiative (OSI).

To make your application public, you need an OSI-approved license file, and also a successfully published version of the application with a source code URL for the version. You can't update the license of an application after the application is created.

If you can't make your application public because you are missing a license file, delete the application and create a new one with the same name. Make sure that you provide it with one or more open-source licenses approved by the Open Source Initiative (OSI) organization.

A Quota Was Exceeded

If you receive an error message that indicates that a quota was exceeded, check to see if you reached a resource quota. For Amazon Serverless Application Repository quotas, see Amazon Serverless Application Repository Quotas.

An Updated Readme File Doesn't Appear Immediately

When you make your application public, the contents of your application can take up to 24 hours to update. If you experience delays longer than 24 hours, try contacting Amazon Support for help. For details, see following.

You Can't Deploy an Application Due to Insufficient IAM Permissions

To deploy an Amazon Serverless Application Repository application, you need permissions to Amazon Serverless Application Repository resources and Amazon CloudFormation stacks. You might also need permission to use the underlying services described in the application. For example, if you're creating an Amazon S3 bucket or an Amazon DynamoDB table, you need permissions to Amazon S3 or DynamoDB.

If you run into this type of issue, review your Amazon Identity and Access Management (IAM) policy and verify that you have the necessary permissions. For more information, see Controlling Access with Amazon Identity and Access Management.

You Can't Deploy the Same Application Twice

The application name that you provide is used as the name of the Amazon CloudFormation stack. If you have problems deploying an application, make sure that you don't have an existing Amazon CloudFormation stack with the same name. If you do, provide a different application name or delete the existing stack to deploy the application with the same name.

Why Is My Application Not Publicly Available

Applications are private by default. In order to make your application public, follow the steps here.

Contacting Support

In some cases, you might not be able to find troubleshooting solutions in this section or through the Amazon Serverless Application Repository forums. If you have Amazon Premium Support, you can create a technical support case at Amazon Support.

Before you contact Amazon Support, make sure to get the Amazon Resource Name (ARN) for the application that you have questions about. You can find the application ARN in the Amazon Serverless Application Repository console.