# metalcloud-cli custom-iso create

Create a new custom ISO from configuration

## Synopsis

Create a new custom ISO image using a JSON configuration file or piped input.

The configuration must include all required fields such as name, description,
and ISO source. Use the config-example command to see the expected format.

Required flags:
  --config-source   Source of the configuration (required)
                    Can be 'pipe' to read from stdin or path to a JSON file

Required permissions:
  - custom_iso:write

Dependencies:
  - Valid JSON configuration matching the expected schema
  - Accessible ISO source if specified in configuration

Examples:
  ## Create custom ISO from a JSON file
  metalcloud-cli custom-iso create --config-source config.json
  
  ## Create custom ISO from piped JSON
  cat config.json | metalcloud-cli custom-iso create --config-source pipe
  
  ## Create using shorter alias
  metalcloud-cli iso new --config-source my-iso-config.json

```
metalcloud-cli custom-iso create [flags]
```

### Options

```
      --config-source string   Source of the new custom ISO configuration. Can be 'pipe' or path to a JSON file.
  -h, --help                   help for create
```

### Options inherited from parent commands

```
  -k, --api_key string         MetalCloud API key
  -c, --config string          Config file path
  -d, --debug                  Set to enable debug logging
  -e, --endpoint string        MetalCloud API endpoint
  -f, --format string          Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
  -i, --insecure_skip_verify   Set to allow insecure transport
  -l, --log_file string        Log file path
  -v, --verbosity string       Log level verbosity (default "INFO")
```

### SEE ALSO

* [metalcloud-cli custom-iso](/content/configuration/cli/metalcloud-cli_custom-iso.md)	 - Manage custom ISO images for server provisioning

#### Auto generated by spf13/cobra on 11-Aug-2025