If you are encountering an "Error 500 – Internal server error" when adding new images to scan in Aqua, it could be due to several reasons. This article will help you troubleshoot and resolve this issue.


This KB article is valid for all supported versions of Aqua, including Aqua Self_Hosted Edition and Aqua SaaS Edition.


The symptom of this issue is an error message that reads "Error 500 – Internal server error" when trying to add a new image to scan in the Aqua platform.


One possible cause of this issue is that the user has exceeded their entitled repositories limit. 


To troubleshoot this issue, you need to check the server logs to find out why adding images fails. You can do this by going to Settings -> Supportability -> Server Log and scrolling to the end to see details. If required, enable DEBUG and try to add an image again to reproduce the issue and come back to view the detailed logs.

If you see an error as below, it means you have exceeded your entitled repositories limit:

Error in AddImagesNew: failed creating repository <image-name>: repositories license capacity exhausted while attempting to add repository <image-name>

To check the number of repositories currently added in your environment, go to the "Images" page and remove any filters from this page.

You can see your entitlement or allowed repositories from Account Management -> Licenses & Plans -> Enterprise licenses section for Aqua SAAS edition and Settings -> Licenses page for Aqua self hosted edition.

Tips and Tricks

Make sure to regularly monitor notifications/alerts about licenses under Workloads Protection -> Notifications page, which you can access by clicking on the bell icon at the bottom.

Please consult your sales representative or CSM if you would like to purchase additional entitlements.

For any other issues please consult the Aqua support team by creating a new support ticket.


In conclusion, the "Error 500 – Internal server error" when adding images to scan in Aqua can be caused by several reasons. By following the troubleshooting steps outlined in this article, you should be able to resolve the issue and successfully add images to scan in Aqua.

Additional Resources

For more information on Licenses, refer to the Aqua documentation at