Scratch Org Error Codes

If your Scratch Org creation fails, you may receive an error message with a code. Use this guide to understand why your Scratch Org creation failed based on the code you received:

Error CodeDescription
C-9998Not a valid scratch org. Contact Salesforce Customer Support for assistance.
C-9999Generic fatal error. Contact Salesforce Customer Support for assistance.
S-1017
Namespace isn’t registered. To use a namespace with a scratch org, you must link the Developer Edition org where the namespace is registered to a Dev Hub org. See Salesforce Help: Link a Namespace to a Dev Hub Org.
S-2006Invalid country.
SH-0001Can’t create scratch org from org shape. Contact the source org admin to add your Dev Hub org ID. From Setup, in the Quick Find box, enter Org Shape, and then select Org Shape.
SH-0002Can’t create scratch org. No org shape exists for the specified sourceOrg. Create an org shape and try again.
SH-0003Can’t create scratch org from org shape. The org shape version is outdated. Recreate the org shape and try again.
SH-9999
Can’t validate org shape due to fatal error. Contact Salesforce Customer Support for assistance.