Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Use the Copilot Managed Runtime CLI to view and configure settings for an app. The CLI stores configured settings in the app's ms.config.json file. You can also add a custom app icon by updating this file.
Available app settings
The following app setting is available through ms app get-settings and ms app set-setting. To configure an app icon, see Add an app icon.
| Setting | Type | Default | Description |
|---|---|---|---|
show-header |
Boolean | true |
Shows or hides the app header bar. |
View app settings
To view all app settings and their effective values, use ms app get-settings:
ms app get-settings
The command displays each setting and its current value:
show-header = true
An effective value includes the default when a setting isn't explicitly configured in ms.config.json.
To return the settings as JSON for use in scripts or automation, add the --json flag:
ms app get-settings --json
The command returns:
{
"success": true,
"settings": {
"showHeader": true
}
}
Configure an app setting
Use ms app set-setting with the setting flag and a value. Boolean values must be true or false.
For example, to hide the app header bar, run:
ms app set-setting --show-header false
The command updates ms.config.json and confirms the configured value:
show-header = false
The resulting configuration includes the following setting:
{
"appSettings": {
"showHeader": false
}
}
Configured settings take effect the next time you run ms app dev or ms app deploy.
Add an app icon
Add a custom icon to help users identify your app in the Copilot Managed Runtime portal. Configure the icon by adding iconPath to ms.config.json. There's no separate CLI command or flag for this setting.
Add a PNG or JPG image to your project. For example, place an image named
custom-icon.pngin thepublicfolder at the project root. Its path relative to the project root ispublic/custom-icon.png. You can use a different folder or file name; updateiconPathin the next step to match.In
ms.config.json, addiconPathas a top-level property, alongside the existing configuration:{ "iconPath": "public/custom-icon.png" }The example shows only the property to add. Keep the other properties in your file.
Specify the path relative to the project root, which is the directory that contains
ms.config.json. Use forward slashes (/) for compatibility with local and cloud builds.Commit and push the image and updated
ms.config.json, then deploy the app by using your existing release workflow. For more information, see Build, preview, and deploy apps.
After you deploy the update, the icon appears with your app in the Copilot Managed Runtime portal. If you don't specify iconPath, the app uses the platform's default icon.