Create a configuration

Creates a new configuration for a specified app. A configuration defines the settings for a deployment, such as the image to use, environment variables, persistent folders and the ports to expose.

Configs are quite complex objects, so we recommend using the dashboard to create and manage them. However, you can also create and manage them using the CLI.

This command can be used in two ways:

1. Interactive mode: Run the command without any flags to be prompted for the required information. Use the --dry-run flag to see the JSON payload that would be sent to the API without actually creating the configuration.
2. Non-interactive mode: Use the --payload flag to specify a JSON payload to create the configuration.

Usage#

odin fleet configs create [--payload=JSON_PAYLOAD] [--dry-run]

Examples#

Create a new configuration interactively and see the JSON payload that would be sent to the API:

odin fleet configs create --dry-run

This will output the JSON payload that would be sent to the API. You can use this payload to create the configuration with the --payload flag:

odin fleet configs create --payload='{"name":"My Config...."}' --force

This is useful for automation of server configuration creation. You can interactively create a configuration or create a configuration in the dashboard and use the Get command to get the JSON payload using the --format=json flag. Then use a tool like jq to modify the payload and create a new configuration using the --payload flag.

Flags#

If you want to create a configuration interactively, you can run the command without any flags. The CLI will prompt you for the required information.

• --dry-run:
  An optional flag that shows the JSON payload that would be sent to the API without actually creating the configuration. You can use that payload to create the configuration with the --payload flag.
• --payload=<string>:
  An optional flag that allows you to specify a JSON payload to create the configuration. This is useful for non-interactive mode and if you want to create a configuration with a specific configuration.

Global Flags#