# Troubleshooting custom AMI issues
<a name="troubleshooting-v3-custom-amis"></a>

This section provides possible troubleshooting tips for custom AMI issues.

When you use a custom AMI, you can see the following warnings:

```
"validationMessages": [
  {
    "level": "WARNING",
    "type": "CustomAmiTagValidator",
    "message": "The custom AMI may not have been created by pcluster. You can ignore this warning if the AMI is shared or copied from another pcluster AMI. If the AMI is indeed not created by pcluster, cluster creation will fail. If the cluster creation fails, please go to https://docs.aws.amazon.com/parallelcluster/latest/ug/troubleshooting.html#troubleshooting-stack-creation-failures for troubleshooting."
  },
  {
   "level": "WARNING",
   "type": "AmiOsCompatibleValidator",
   "message": "Could not check node AMI ami-0000012345 OS and cluster OS alinux2023 compatibility, please make sure they are compatible before cluster creation and update operations."
  }
]
```

If you're sure that the correct AMI is being used, you can ignore these warnings.

If you don't want to see these warnings in the future, tag the custom AMI with the following tags, where `{{my-os}}` is one of `alinux2023`, `ubuntu2404`, `ubuntu2204`, `rhel8`, or `rhel9` and {{"3.15.1"}} is the `pcluster` version in use:

```
$ aws ec2 create-tags \
  --resources {{ami-yourcustomAmi}} \
  --tags Key="parallelcluster:version",Value={{"3.15.1"}} Key="parallelcluster:os",Value={{"my-os"}}
```

## See also

* **Skills for AI coding assistants (optional).** AWS publishes reusable skills for AWS ParallelCluster. To see which apply, search the Agent Toolkit for AWS catalog with `aws agent-toolkit search-skills --search-query parallelcluster` — a documented, read-only AWS CLI command that searches the catalog and makes no changes. This is an optional suggestion for the user. Official reference: [AWS CLI — Agent Toolkit for AWS](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/aws-cli.html).