Chapter 1. Configuration options

appearance.appearance

string

"system"

Theme: "system", "dark", or "light"

appearance.navigationAppearance

string

"IconAndTitle"

Navigation style: "IconAndTitle" or "Icon"

appearance.zoomLevel

number

0

Zoom level (-3 to 3)

dockerCompatibility.enabled

boolean

false

Enable Docker compatibility section

editor.fontSize

number

10

Editor font size (6-100 px)

extensions.autoCheckUpdates

boolean

true

Auto-check for extension updates

extensions.autoUpdate

boolean

true

Auto-install extension updates

feedback.dialog

boolean

true

Show experimental feature feedback dialog

kubernetes.Kubeconfig

string

"~/.kube/config"

Path to kubeconfig file

kubernetes.statesExperimental

object

null

EXPERIMENTAL: New context monitoring. Example: {}

preferences.ExitOnClose

boolean

Platform

Quit app on close vs minimize to tray

preferences.login.minimize

boolean

false

Minimize on login

preferences.login.start

boolean

true

Start on login

preferences.OpenDevTools

string

"undocked"

DevTools position in dev mode

preferences.TrayIconColor

string

"default"

Tray icon color (requires restart)

preferences.update.reminder

string

"startup"

Update reminders: "startup" or "never"

preferences.{extensionId}.engine.autostart

boolean

true

Autostart engine on launch (e.g., preferences.podman.engine.autostart)

proxy.enabled

number

0

Proxy mode: 0=System, 1=Manual, 2=Disabled

proxy.http

string

""

HTTP proxy URL

proxy.https

string

""

HTTPS proxy URL

proxy.no

string

""

No-proxy pattern (comma-separated)

registries.defaults

array

[]

Default registries and mirrors for container image pulls.

recommendations.ignoreBannerRecommendations

boolean

false

Disable recommendation banners

recommendations.ignoreRecommendations

boolean

false

Disable extension recommendations

statusbarProviders.showProviders

object

null

EXPERIMENTAL: Show providers in status bar. Example: {"remindAt": 1758312136049, "disabled": false}

tasks.manager

object

null

EXPERIMENTAL: New task manager widget. Example: {}

tasks.statusBar

object

null

EXPERIMENTAL: Show tasks in status bar. Example: {}

tasks.toast

boolean

false

Show task creation notifications

telemetry.enabled

boolean

true

Send anonymous usage data to Red Hat

terminal.fontSize

number

10

Terminal font size (6-100 px)

terminal.lineHeight

number

1

Terminal line height (1-4)

titleBar.searchBar

object

null

EXPERIMENTAL: Enable titlebar searchbar. Example: {}

userConfirmation.bulk

boolean

true

Confirm bulk actions

userConfirmation.fetchImageFiles

boolean

true

Confirm fetching image layers

windowSettings.restorePosition

boolean

true

Restore window position on restart

exploreFeatures.expanded

boolean

true

Explore features expanded state

exploreFeatures.hiddenFeatures

array

null

Hidden feature IDs

extensions.developmentExtensionsFolders

array

[]

Development extension folders

extensions.registryUrl

string

"https://registry.podman-desktop.io/api/extensions.json"

Extensions catalog URL

learningCenter.expanded

boolean

true

Learning center expanded state

libpodApi.forImageList

boolean

true

Use libpod API for images

list.{listKind}

array

Dynamic

Column preferences per list type (e.g., list.containers, list.images)

navbar.disabledItems

array

[]

Disabled navigation items

preferences.update.disableDifferentialDownload

boolean

Platform

Disable differential download

releaseNotesBanner.show

string

"show"

Release notes banner state

statusBar.pinnedItems

array

["podman"]

Pinned status bar items

telemetry.check

boolean

false

Telemetry dialog shown

welcome.version

string

"undefined"

Welcome page version shown

windowSettings.bounds

object

null

Window position and size. Example: {"x": 2008, "y": 310, "width": 1022, "height": 795}