跳到主要内容

Configuration

The Tauri configuration object. It is read from a file where you can define your frontend assets, configure the bundler, enable the app updater, define a system tray, enable APIs via the allowlist and more.

The configuration file is generated by the tauri init command that lives in your Tauri application source directory (src-tauri).

Once generated, you may modify it at will to customize your Tauri application.

File Formats

By default, the configuration is defined as a JSON file named tauri.conf.json.

Tauri also supports JSON5 and TOML files via the config-json5 and config-toml Cargo features, respectively. The JSON5 file name must be either tauri.conf.json or tauri.conf.json5. The TOML file name is Tauri.toml.

Platform-Specific Configuration

In addition to the default configuration file, Tauri can read a platform-specific configuration from tauri.linux.conf.json, tauri.windows.conf.json, and tauri.macos.conf.json (or Tauri.linux.toml, Tauri.windows.toml and Tauri.macos.toml if the Tauri.toml format is used), which gets merged with the main configuration object.

Configuration Structure

The configuration is composed of the following objects:

Example tauri.config.json file
{
"build": {
"beforeBuildCommand": "",
"beforeDevCommand": "",
"devPath": "../dist",
"distDir": "../dist"
},
"package": {
"productName": "tauri-app",
"version": "0.1.0"
},
"tauri": {
"allowlist": {
"all": true
},
"bundle": {},
"security": {
"csp": null
},
"updater": {
"active": false
},
"windows": [
{
"fullscreen": false,
"height": 600,
"resizable": true,
"title": "Tauri App",
"width": 800
}
]
}
}

PackageConfig

The package configuration.

Type: object

NameTypeDefaultDescription
productName
string?nullApp name.
version
string?nullApp version. It is a semver version number or a path to a package.json file containing the version field.

TauriConfig

The Tauri configuration object.

Type: object

NameTypeDefaultDescription
pattern
PatternKindviewThe pattern to use.
windows
WindowConfig[][]The windows configuration.
cli
CliConfig?viewThe CLI configuration.
bundle
BundleConfigviewThe bundler configuration.
allowlist
AllowlistConfigviewThe allowlist configuration.
security
SecurityConfigviewSecurity configuration.
updater
UpdaterConfigviewThe updater configuration.
systemTray
SystemTrayConfig?viewConfiguration for app system tray.
macOSPrivateApi
booleanfalseMacOS private API configuration. Enables the transparent background API and sets the fullScreenEnabled preference to true.

PatternKind

The application pattern.

Can be any ONE of the following types:

  • { "use": "brownfield" }: Brownfield pattern.
  • { "use": "isolation", "options": { "dir": string } }: Isolation pattern. Recommended for security purposes.

WindowConfig

The window configuration object.

Type: object

NameTypeDefaultDescription
label
stringnullThe window identifier. It must be alphanumeric.
url
WindowUrlviewThe window webview URL.
userAgent
string?nullThe user agent for the webview
fileDropEnabled
booleantrueWhether the file drop is enabled or not on the webview. By default it is enabled.

Disabling it is required to use drag and drop on the frontend on Windows.
center
booleanfalseWhether or not the window starts centered or not.
x
number? (format: double)nullThe horizontal position of the window's top left corner
y
number? (format: double)nullThe vertical position of the window's top left corner
width
number (format: double)800The window width.
height
number (format: double)600The window height.
minWidth
number? (format: double)nullThe min window width.
minHeight
number? (format: double)nullThe min window height.
maxWidth
number? (format: double)nullThe max window width.
maxHeight
number? (format: double)nullThe max window height.
resizable
booleantrueWhether the window is resizable or not.
title
stringnullThe window title.
fullscreen
booleanfalseWhether the window starts as fullscreen or not.
focus
booleantrueWhether the window will be initially focused or not.
transparent
booleanfalseWhether the window is transparent or not.

Note that on macOS this requires the macos-private-api feature flag, enabled under tauri > macOSPrivateApi. WARNING: Using private APIs on macOS prevents your application from being accepted to the App Store.
maximized
booleanfalseWhether the window is maximized or not.
visible
booleantrueWhether the window is visible or not.
decorations
booleantrueWhether the window should have borders and bars.
alwaysOnTop
booleanfalseWhether the window should always be on top of other windows.
contentProtected
booleanfalsePrevents the window contents from being captured by other apps.
skipTaskbar
booleanfalseIf true, hides the window icon from the taskbar on Windows and Linux.
theme
Theme?viewThe initial window theme. Defaults to the system theme. Only implemented on Windows and macOS 10.14+.
titleBarStyle
TitleBarStyleviewThe style of the macOS title bar.
hiddenTitle
booleanfalseIf true, sets the window title to be hidden on macOS.
acceptFirstMouse
booleanfalseWhether clicking an inactive window also clicks through to the webview on macOS.
tabbingIdentifier
string?nullDefines the window [tabbing identifier] for macOS.

Windows with matching tabbing identifiers will be grouped together. If the tabbing identifier is not set, automatic tabbing will be disabled.

[tabbing identifier]: https://developer.apple.com/documentation/appkit/nswindow/1644704-tabbingidentifier
additionalBrowserArgs
string?nullDefines additional browser arguments on Windows. By default wry passes --disable-features=msWebOOUI,msPdfOOUI,msSmartScreenProtection so if you use this method, you also need to disable these components by yourself if you want.

WindowUrl

An URL to open on a Tauri webview window.

Can be any of the following types:

  • string (format: uri): An external URL.
  • string: The path portion of an app URL. For instance, to load tauri://localhost/users/john, you can simply provide users/john in this configuration.

Theme

System theme.

Can be any ONE of the following types:

  • "Light": Light theme.
  • "Dark": Dark theme.

TitleBarStyle

How the window title bar should be displayed on macOS.

Can be any ONE of the following types:

  • "Visible": A normal title bar.

  • "Transparent": Makes the title bar transparent, so the window background color is shown instead.

    Useful if you don't need to have actual HTML under the title bar. This lets you avoid the caveats of using TitleBarStyle::Overlay. Will be more useful when Tauri lets you set a custom window background color.

  • "Overlay": Shows the title bar as a transparent overlay over the window's content.

    Keep in mind:

  • The height of the title bar is different on different OS versions, which can lead to window the controls and title not being where you don't expect.

  • You need to define a custom drag region to make your window draggable, however due to a limitation you can't drag the window when it's not in focus https://github.com/tauri-apps/tauri/issues/4316.

  • The color of the window title depends on the system theme.

CliConfig

describes a CLI configuration

Type: object

NameTypeDefaultDescription
description
string?nullCommand description which will be shown on the help information.
longDescription
string?nullCommand long description which will be shown on the help information.
beforeHelp
string?nullAdds additional help information to be displayed in addition to auto-generated help. This information is displayed before the auto-generated help information. This is often used for header information.
afterHelp
string?nullAdds additional help information to be displayed in addition to auto-generated help. This information is displayed after the auto-generated help information. This is often used to describe how to use the arguments, or caveats to be noted.
args
array?nullList of arguments for the command
subcommands
object?nullList of subcommands of this command

CliArg

A CLI argument definition.

Type: object

NameTypeDefaultDescription
short
string?nullThe short version of the argument, without the preceding -.

NOTE: Any leading - characters will be stripped, and only the first non-character will be used as the short version.
name
string(required)nullThe unique argument name
description
string?nullThe argument description which will be shown on the help information. Typically, this is a short (one line) description of the arg.
longDescription
string?nullThe argument long description which will be shown on the help information. Typically this a more detailed (multi-line) message that describes the argument.
takesValue
booleanfalseSpecifies that the argument takes a value at run time.

NOTE: values for arguments may be specified in any of the following methods
- Using a space such as -o value or --option value
- Using an equals and no space such as -o=value or --option=value
- Use a short and no space such as -ovalue
multiple
booleanfalseSpecifies that the argument may have an unknown number of multiple values. Without any other settings, this argument may appear only once.

For example, --opt val1 val2 is allowed, but --opt val1 val2 --opt val3 is not.

NOTE: Setting this requires takes_value to be set to true.
multipleOccurrences
booleanfalseSpecifies that the argument may appear more than once. For flags, this results in the number of occurrences of the flag being recorded. For example -ddd or -d -d -d would count as three occurrences. For options or arguments that take a value, this does not affect how many values they can accept. (i.e. only one at a time is allowed)

For example, --opt val1 --opt val2 is allowed, but --opt val1 val2 is not.
numberOfValues
integer? (format: uint)nullSpecifies how many values are required to satisfy this argument. For example, if you had a -f <file> argument where you wanted exactly 3 'files' you would set number_of_values = 3, and this argument wouldn't be satisfied unless the user provided 3 and only 3 values.

NOTE: Does not require multiple_occurrences = true to be set. Setting multiple_occurrences = true would allow -f <file> <file> <file> -f <file> <file> <file> where as not setting it would only allow one occurrence of this argument.

NOTE: implicitly sets takes_value = true and multiple_values = true.
possibleValues
array?nullSpecifies a list of possible values for this argument. At runtime, the CLI verifies that only one of the specified values was used, or fails with an error message.
minValues
integer? (format: uint)nullSpecifies the minimum number of values for this argument. For example, if you had a -f <file> argument where you wanted at least 2 'files', you would set minValues: 2, and this argument would be satisfied if the user provided, 2 or more values.
maxValues
integer? (format: uint)nullSpecifies the maximum number of values are for this argument. For example, if you had a -f <file> argument where you wanted up to 3 'files', you would set .max_values(3), and this argument would be satisfied if the user provided, 1, 2, or 3 values.
required
booleanfalseSets whether or not the argument is required by default.

- Required by default means it is required, when no other conflicting rules have been evaluated
- Conflicting rules take precedence over being required.
requiredUnlessPresent
string?nullSets an arg that override this arg's required setting i.e. this arg will be required unless this other argument is present.
requiredUnlessPresentAll
array?nullSets args that override this arg's required setting i.e. this arg will be required unless all these other arguments are present.
requiredUnlessPresentAny
array?nullSets args that override this arg's required setting i.e. this arg will be required unless at least one of these other arguments are present.
conflictsWith
string?nullSets a conflicting argument by name i.e. when using this argument, the following argument can't be present and vice versa.
conflictsWithAll
array?nullThe same as conflictsWith but allows specifying multiple two-way conflicts per argument.
requires
string?nullTets an argument by name that is required when this one is present i.e. when using this argument, the following argument must be present.
requiresAll
array?nullSts multiple arguments by names that are required when this one is present i.e. when using this argument, the following arguments must be present.
requiresIf
array?nullAllows a conditional requirement with the signature [arg, value] the requirement will only become valid if arg's value equals ${value}.
requiredIfEq
array?nullAllows specifying that an argument is required conditionally with the signature [arg, value] the requirement will only become valid if the arg's value equals ${value}.
requireEquals
boolean?nullRequires that options use the --option=val syntax i.e. an equals between the option and associated value.
index
integer? (format: uint, minimum: 1)nullThe positional argument index, starting at 1.

The index refers to position according to other positional argument. It does not define position in the argument list as a whole. When utilized with multiple=true, only the last positional argument may be defined as multiple (i.e. the one with the highest index).

BundleConfig

Configuration for tauri-bundler.

Type: object

NameTypeDefaultDescription
active
booleanfalseWhether Tauri should bundle your application or just output the executable.
targets
BundleTargetviewThe bundle targets, currently supports ["deb", "appimage", "nsis", "msi", "app", "dmg", "updater"] or "all".
identifier
string(required)nullThe application identifier in reverse domain name notation (e.g. com.tauri.example). This string must be unique across applications since it is used in system configurations like the bundle ID and path to the webview data directory. This string must contain only alphanumeric characters (A–Z, a–z, and 0–9), hyphens (-), and periods (.).
publisher
string?nullThe application's publisher. Defaults to the second element in the identifier string. Currently maps to the Manufacturer property of the Windows Installer.
icon
string[][]The app's icons
resources
array?nullApp resources to bundle. Each resource is a path to a file or directory. Glob patterns are supported.
copyright
string?nullA copyright string associated with your application.
category
string?nullThe application kind.

Should be one of the following: Business, DeveloperTool, Education, Entertainment, Finance, Game, ActionGame, AdventureGame, ArcadeGame, BoardGame, CardGame, CasinoGame, DiceGame, EducationalGame, FamilyGame, KidsGame, MusicGame, PuzzleGame, RacingGame, RolePlayingGame, SimulationGame, SportsGame, StrategyGame, TriviaGame, WordGame, GraphicsAndDesign, HealthcareAndFitness, Lifestyle, Medical, Music, News, Photography, Productivity, Reference, SocialNetworking, Sports, Travel, Utility, Video, Weather.
shortDescription
string?nullA short description of your application.
longDescription
string?nullA longer, multi-line description of the application.
appimage
AppImageConfigviewConfiguration for the AppImage bundle.
deb
DebConfigviewConfiguration for the Debian bundle.
macOS
MacConfigviewConfiguration for the macOS bundles.
externalBin
array?nullA list of—either absolute or relative—paths to binaries to embed with your application.

Note that Tauri will look for system-specific binaries following the pattern "binary-name{-target-triple}{.system-extension}".

E.g. for the external binary "my-binary", Tauri looks for:

- "my-binary-x86_64-pc-windows-msvc.exe" for Windows
- "my-binary-x86_64-apple-darwin" for macOS
- "my-binary-x86_64-unknown-linux-gnu" for Linux

so don't forget to provide binaries for all targeted platforms.
windows
WindowsConfigviewConfiguration for the Windows bundle.

BundleTarget

Targets to bundle. Each value is case insensitive.

Can be any of the following types:

BundleType

A bundle referenced by tauri-bundler.

Can be any ONE of the following types:

  • "deb": The debian bundle (.deb).
  • "appimage": The AppImage bundle (.appimage).
  • "msi": The Microsoft Installer bundle (.msi).
  • "nsis": The NSIS bundle (.exe).
  • "app": The macOS application bundle (.app).
  • "dmg": The Apple Disk Image bundle (.dmg).
  • "updater": The Tauri updater bundle.

AppImageConfig

Configuration for AppImage bundles.

Type: object

NameTypeDefaultDescription
bundleMediaFramework
booleanfalseInclude additional gstreamer dependencies needed for audio and video playback. This increases the bundle size by ~15-35MB depending on your build system.

DebConfig

Configuration for Debian (.deb) bundles.

Type: object

NameTypeDefaultDescription
depends
array?nullThe list of deb dependencies your application relies on.
files
objectnullThe files to include on the package.

MacConfig

Configuration for the macOS bundles.

Type: object

NameTypeDefaultDescription
frameworks
array?nullA list of strings indicating any macOS X frameworks that need to be bundled with the application.

If a name is used, ".framework" must be omitted and it will look for standard install locations. You may also use a path to a specific framework.
minimumSystemVersion
string?nullA version string indicating the minimum macOS X version that the bundled application supports. Defaults to 10.13.

Setting it to null completely removes the LSMinimumSystemVersion field on the bundle's Info.plist and the MACOSX_DEPLOYMENT_TARGET environment variable.

An empty string is considered an invalid value so the default value is used.
exceptionDomain
string?nullAllows your application to communicate with the outside world. It should be a lowercase, without port and protocol domain name.
license
string?nullThe path to the license file to add to the DMG bundle.
signingIdentity
string?nullIdentity to use for code signing.
providerShortName
string?nullProvider short name for notarization.
entitlements
string?nullPath to the entitlements file.

WindowsConfig

Windows bundler configuration.

Type: object

NameTypeDefaultDescription
digestAlgorithm
string?nullSpecifies the file digest algorithm to use for creating file signatures. Required for code signing. SHA-256 is recommended.
certificateThumbprint
string?nullSpecifies the SHA1 hash of the signing certificate.
timestampUrl
string?nullServer to use during timestamping.
tsp
booleanfalseWhether to use Time-Stamp Protocol (TSP, a.k.a. RFC 3161) for the timestamp server. Your code signing provider may use a TSP timestamp server, like e.g. SSL.com does. If so, enable TSP by setting to true.
webviewInstallMode
WebviewInstallModeviewThe installation mode for the Webview2 runtime.
webviewFixedRuntimePath
string?nullPath to the webview fixed runtime to use. Overwrites webview_install_mode if set.

Will be removed in v2, prefer the webview_install_mode option.

The fixed version can be downloaded on the official website. The .cab file must be extracted to a folder and this folder path must be defined on this field.
allowDowngrades
booleantrueValidates a second app installation, blocking the user from installing an older version if set to false.

For instance, if 1.2.1 is installed, the user won't be able to install app version 1.2.0 or 1.1.5.

The default value of this flag is true.
wix
WixConfig?viewConfiguration for the MSI generated with WiX.
nsis
NsisConfig?viewConfiguration for the installer generated with NSIS.

WebviewInstallMode

Install modes for the Webview2 runtime. Note that for the updater bundle DownloadBootstrapper is used.

For more information see https://tauri.app/v1/guides/building/windows.

Can be any ONE of the following types:

  • { "type": "skip" }: Do not install the Webview2 as part of the Windows Installer.
  • { "type": "downloadBootstrapper", "silent": boolean }: Download the bootstrapper and run it. Requires an internet connection. Results in a smaller installer size, but is not recommended on Windows 7.
  • { "type": "embedBootstrapper", "silent": boolean }: Embed the bootstrapper and run it. Requires an internet connection. Increases the installer size by around 1.8MB, but offers better support on Windows 7.
  • { "type": "offlineInstaller", "silent": boolean }: Embed the offline installer and run it. Does not require an internet connection. Increases the installer size by around 127MB.
  • { "type": "fixedRuntime", "path": string }: Embed a fixed webview2 version and use it at runtime. Increases the installer size by around 180MB.

WixConfig

Configuration for the MSI bundle using WiX.

Type: object

NameTypeDefaultDescription
language
WixLanguageviewThe installer languages to build. See https://docs.microsoft.com/en-us/windows/win32/msi/localizing-the-error-and-actiontext-tables.
template
string?nullA custom .wxs template to use.
fragmentPaths
string[][]A list of paths to .wxs files with WiX fragments to use.
componentGroupRefs
string[][]The ComponentGroup element ids you want to reference from the fragments.
componentRefs
string[][]The Component element ids you want to reference from the fragments.
featureGroupRefs
string[][]The FeatureGroup element ids you want to reference from the fragments.
featureRefs
string[][]The Feature element ids you want to reference from the fragments.
mergeRefs
string[][]The Merge element ids you want to reference from the fragments.
skipWebviewInstall
booleanfalseDisables the Webview2 runtime installation after app install.

Will be removed in v2, prefer the [WindowsConfig::webview_install_mode] option.
license
string?nullThe path to the license file to render on the installer.

Must be an RTF file, so if a different extension is provided, we convert it to the RTF format.
enableElevatedUpdateTask
booleanfalseCreate an elevated update task within Windows Task Scheduler.
bannerPath
string?nullPath to a bitmap file to use as the installation user interface banner. This bitmap will appear at the top of all but the first page of the installer.

The required dimensions are 493px × 58px.
dialogImagePath
string?nullPath to a bitmap file to use on the installation user interface dialogs. It is used on the welcome and completion dialogs. The required dimensions are 493px × 312px.

WixLanguage

The languages to build using WiX.

Can be any of the following types:

  • string: A single language to build, without configuration.
  • string[]: A list of languages to build, without configuration.
  • object: A map of languages and its configuration.

WixLanguageConfig

Configuration for a target language for the WiX build.

Type: object

NameTypeDefaultDescription
localePath
string?nullThe path to a locale (.wxl) file. See https://wixtoolset.org/documentation/manual/v3/howtos/ui_and_localization/build_a_localized_version.html.

NsisConfig

Configuration for the Installer bundle using NSIS.

Type: object

NameTypeDefaultDescription
license
string?nullThe path to the license file to render on the installer.
headerImage
string?nullThe path to a bitmap file to display on the header of installers pages.

The recommended dimensions are 150px x 57px.
sidebarImage
string?nullThe path to a bitmap file for the Welcome page and the Finish page.

The recommended dimensions are 164px x 314px.
installerIcon
string?nullThe path to an icon file used as the installer icon.
installMode
NSISInstallerModeviewWhether the installation will be for all users or just the current user.
languages
array?nullA list of installer languages. By default the OS language is used. If the OS language is not in the list of languages, the first language will be used. To allow the user to select the language, set display_language_selector to true.

See https://github.com/kichik/nsis/tree/9465c08046f00ccb6eda985abbdbf52c275c6c4d/Contrib/Language%20files for the complete list of languages.
displayLanguageSelector
booleanfalseWhether to display a language selector dialog before the installer and uninstaller windows are rendered or not. By default the OS language is selected, with a fallback to the first language in the languages array.

NSISInstallerMode

Install Modes for the NSIS installer.

Can be any ONE of the following types:

  • "currentUser": Default mode for the installer.

    Install the app by default in a directory that doesn't require Administrator access.

Installer metadata will be saved under the HKCU registry path.

  • "perMachine": Install the app by default in the Program Files folder directory requires Administrator access for the installation.

    Installer metadata will be saved under the HKLM registry path.

  • "both": Combines both modes and allows the user to choose at install time whether to install for the current user or per machine. Note that this mode will require Administrator access even if the user wants to install it for the current user only.

    Installer metadata will be saved under the HKLM or HKCU registry path based on the user's choice.

AllowlistConfig

Allowlist configuration. The allowlist is a translation of the Cargo allowlist features.

Notes

  • Endpoints that don't have their own allowlist option are enabled by default.
  • There is only "opt-in", no "opt-out". Setting an option to false has no effect.

Examples

    • "app-all": true will make the hide endpoint be available regardless of whether hide is set to false or true in the allowlist.

Type: object

NameTypeDefaultDescription
all
booleanfalseUse this flag to enable all API features.
fs
FsAllowlistConfigviewFile system API allowlist.
window
WindowAllowlistConfigviewWindow API allowlist.
shell
ShellAllowlistConfigviewShell API allowlist.
dialog
DialogAllowlistConfigviewDialog API allowlist.
http
HttpAllowlistConfigviewHTTP API allowlist.
notification
NotificationAllowlistConfigviewNotification API allowlist.
globalShortcut
GlobalShortcutAllowlistConfigviewGlobal shortcut API allowlist.
os
OsAllowlistConfigviewOS allowlist.
path
PathAllowlistConfigviewPath API allowlist.
protocol
ProtocolAllowlistConfigviewCustom protocol allowlist.
process
ProcessAllowlistConfigviewProcess API allowlist.
clipboard
ClipboardAllowlistConfigviewClipboard APIs allowlist.
app
AppAllowlistConfigviewApp APIs allowlist.

FsAllowlistConfig

Allowlist for the file system APIs.

Type: object

NameTypeDefaultDescription
scope
FsAllowlistScope[]The access scope for the filesystem APIs.
all
booleanfalseUse this flag to enable all file system API features.
readFile
booleanfalseRead file from local filesystem.
writeFile
booleanfalseWrite file to local filesystem.
readDir
booleanfalseRead directory from local filesystem.
copyFile
booleanfalseCopy file from local filesystem.
createDir
booleanfalseCreate directory from local filesystem.
removeDir
booleanfalseRemove directory from local filesystem.
removeFile
booleanfalseRemove file from local filesystem.
renameFile
booleanfalseRename file from local filesystem.
exists
booleanfalseCheck if path exists on the local filesystem.

FsAllowlistScope

Filesystem scope definition. It is a list of glob patterns that restrict the API access from the webview.

Each pattern can start with a variable that resolves to a system base directory. The variables are: $AUDIO, $CACHE, $CONFIG, $DATA, $LOCALDATA, $DESKTOP, $DOCUMENT, $DOWNLOAD, $EXE, $FONT, $HOME, $PICTURE, $PUBLIC, $RUNTIME, $TEMPLATE, $VIDEO, $RESOURCE, $APP, $LOG, $TEMP, $APPCONFIG, $APPDATA, $APPLOCALDATA, $APPCACHE, $APPLOG.

Can be any of the following types:

  • string[]: A list of paths that are allowed by this scope.
  • object: A complete scope configuration.

WindowAllowlistConfig

Allowlist for the window APIs.

Type: object

NameTypeDefaultDescription
all
booleanfalseUse this flag to enable all window API features.
create
booleanfalseAllows dynamic window creation.
center
booleanfalseAllows centering the window.
requestUserAttention
booleanfalseAllows requesting user attention on the window.
setResizable
booleanfalseAllows setting the resizable flag of the window.
setTitle
booleanfalseAllows changing the window title.
maximize
booleanfalseAllows maximizing the window.
unmaximize
booleanfalseAllows unmaximizing the window.
minimize
booleanfalseAllows minimizing the window.
unminimize
booleanfalseAllows unminimizing the window.
show
booleanfalseAllows showing the window.
hide
booleanfalseAllows hiding the window.
close
booleanfalseAllows closing the window.
setDecorations
booleanfalseAllows setting the decorations flag of the window.
setAlwaysOnTop
booleanfalseAllows setting the always_on_top flag of the window.
setContentProtected
booleanfalseAllows preventing the window contents from being captured by other apps.
setSize
booleanfalseAllows setting the window size.
setMinSize
booleanfalseAllows setting the window minimum size.
setMaxSize
booleanfalseAllows setting the window maximum size.
setPosition
booleanfalseAllows changing the position of the window.
setFullscreen
booleanfalseAllows setting the fullscreen flag of the window.
setFocus
booleanfalseAllows focusing the window.
setIcon
booleanfalseAllows changing the window icon.
setSkipTaskbar
booleanfalseAllows setting the skip_taskbar flag of the window.
setCursorGrab
booleanfalseAllows grabbing the cursor.
setCursorVisible
booleanfalseAllows setting the cursor visibility.
setCursorIcon
booleanfalseAllows changing the cursor icon.
setCursorPosition
booleanfalseAllows setting the cursor position.
setIgnoreCursorEvents
booleanfalseAllows ignoring cursor events.
startDragging
booleanfalseAllows start dragging on the window.
print
booleanfalseAllows opening the system dialog to print the window content.

ShellAllowlistConfig

Allowlist for the shell APIs.

Type: object

NameTypeDefaultDescription
scope
ShellAllowlistScope[]Access scope for the binary execution APIs. Sidecars are automatically enabled.
all
booleanfalseUse this flag to enable all shell API features.
execute
booleanfalseEnable binary execution.
sidecar
booleanfalseEnable sidecar execution, allowing the JavaScript layer to spawn a sidecar command, an executable that is shipped with the application. For more information see https://tauri.app/v1/guides/building/sidecar.
open
ShellAllowlistOpenfalseOpen URL with the user's default application.

ShellAllowlistScope

Shell scope definition. It is a list of command names and associated CLI arguments that restrict the API access from the webview.

Type: ShellAllowedCommand[]

ShellAllowedCommand

A command allowed to be executed by the webview API.

Type: object

NameTypeDefaultDescription
name
string(required)nullThe name for this allowed shell command configuration.

This name will be used inside of the webview API to call this command along with any specified arguments.
cmd
stringnullThe command name. It can start with a variable that resolves to a system base directory. The variables are: $AUDIO, $CACHE, $CONFIG, $DATA, $LOCALDATA, $DESKTOP, $DOCUMENT, $DOWNLOAD, $EXE, $FONT, $HOME, $PICTURE, $PUBLIC, $RUNTIME, $TEMPLATE, $VIDEO, $RESOURCE, $APP, $LOG, $TEMP, $APPCONFIG, $APPDATA, $APPLOCALDATA, $APPCACHE, $APPLOG.
args
ShellAllowedArgsfalseThe allowed arguments for the command execution.
sidecar
booleanfalseIf this command is a sidecar command.

ShellAllowedArgs

A set of command arguments allowed to be executed by the webview API.

A value of true will allow any arguments to be passed to the command. false will disable all arguments. A list of [ShellAllowedArg] will set those arguments as the only valid arguments to be passed to the attached command configuration.

Can be any of the following types:

  • boolean: Use a simple boolean to allow all or disable all arguments to this command configuration.
  • ShellAllowedArg[]: A specific set of [ShellAllowedArg] that are valid to call for the command configuration.

ShellAllowedArg

A command argument allowed to be executed by the webview API.

Can be any of the following types:

  • string: A non-configurable argument that is passed to the command in the order it was specified.
  • object: A variable that is set while calling the command from the webview API.

ShellAllowlistOpen

Defines the shell > open api scope.

Can be any of the following types:

  • boolean: If the shell open API should be enabled.

    If enabled, the default validation regex (^((mailto:\w+)|(tel:\w+)|(https?://\w+)).+) is used.

  • string: Enable the shell open API, with a custom regex that the opened path must match against.

    If using a custom regex to support a non-http(s) schema, care should be used to prevent values that allow flag-like strings to pass validation. e.g. --enable-debugging, -i, /R.

DialogAllowlistConfig

Allowlist for the dialog APIs.

Type: object

NameTypeDefaultDescription
all
booleanfalseUse this flag to enable all dialog API features.
open
booleanfalseAllows the API to open a dialog window to pick files.
save
booleanfalseAllows the API to open a dialog window to pick where to save files.
message
booleanfalseAllows the API to show a message dialog window.
ask
booleanfalseAllows the API to show a dialog window with Yes/No buttons.
confirm
booleanfalseAllows the API to show a dialog window with Ok/Cancel buttons.

HttpAllowlistConfig

Allowlist for the HTTP APIs.

Type: object

NameTypeDefaultDescription
scope
HttpAllowlistScope[]The access scope for the HTTP APIs.
all
booleanfalseUse this flag to enable all HTTP API features.
request
booleanfalseAllows making HTTP requests.

HttpAllowlistScope

HTTP API scope definition. It is a list of URLs that can be accessed by the webview when using the HTTP APIs. The scoped URL is matched against the request URL using a glob pattern.

Examples:

Type: string _(format: uri)_[]

NotificationAllowlistConfig

Allowlist for the notification APIs.

Type: object

NameTypeDefaultDescription
all
booleanfalseUse this flag to enable all notification API features.

GlobalShortcutAllowlistConfig

Allowlist for the global shortcut APIs.

Type: object

NameTypeDefaultDescription
all
booleanfalseUse this flag to enable all global shortcut API features.

OsAllowlistConfig

Allowlist for the OS APIs.

Type: object

NameTypeDefaultDescription
all
booleanfalseUse this flag to enable all OS API features.

PathAllowlistConfig

Allowlist for the path APIs.

Type: object

NameTypeDefaultDescription
all
booleanfalseUse this flag to enable all path API features.

ProtocolAllowlistConfig

Allowlist for the custom protocols.

Type: object

NameTypeDefaultDescription
assetScope
FsAllowlistScope[]The access scope for the asset protocol.
all
booleanfalseUse this flag to enable all custom protocols.
asset
booleanfalseEnables the asset protocol.

ProcessAllowlistConfig

Allowlist for the process APIs.

Type: object

NameTypeDefaultDescription
all
booleanfalseUse this flag to enable all process APIs.
relaunch
booleanfalseEnables the relaunch API.
relaunchDangerousAllowSymlinkMacos
booleanfalseDangerous option that allows macOS to relaunch even if the binary contains a symlink.

This is due to macOS having less symlink protection. Highly recommended to not set this flag unless you have a very specific reason too, and understand the implications of it.
exit
booleanfalseEnables the exit API.

ClipboardAllowlistConfig

Allowlist for the clipboard APIs.

Type: object

NameTypeDefaultDescription
all
booleanfalseUse this flag to enable all clipboard APIs.
writeText
booleanfalseEnables the clipboard's writeText API.
readText
booleanfalseEnables the clipboard's readText API.

AppAllowlistConfig

Allowlist for the app APIs.

Type: object

NameTypeDefaultDescription
all
booleanfalseUse this flag to enable all app APIs.
show
booleanfalseEnables the app's show API.
hide
booleanfalseEnables the app's hide API.

SecurityConfig

Security configuration.

Type: object

NameTypeDefaultDescription
csp
Csp?viewThe Content Security Policy that will be injected on all HTML files on the built application. If dev_csp is not specified, this value is also injected on dev.

This is a really important part of the configuration since it helps you ensure your WebView is secured. See https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP.
devCsp
Csp?viewThe Content Security Policy that will be injected on all HTML files on development.

This is a really important part of the configuration since it helps you ensure your WebView is secured. See https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP.
freezePrototype
booleanfalseFreeze the Object.prototype when using the custom protocol.
dangerousDisableAssetCspModification
DisabledCspModificationKindfalseDisables the Tauri-injected CSP sources.

At compile time, Tauri parses all the frontend assets and changes the Content-Security-Policy to only allow loading of your own scripts and styles by injecting nonce and hash sources. This stricts your CSP, which may introduce issues when using along with other flexing sources.

This configuration option allows both a boolean and a list of strings as value. A boolean instructs Tauri to disable the injection for all CSP injections, and a list of strings indicates the CSP directives that Tauri cannot inject.

WARNING: Only disable this if you know what you are doing and have properly configured the CSP. Your application might be vulnerable to XSS attacks without this Tauri protection.
dangerousRemoteDomainIpcAccess
RemoteDomainAccessScope[][]Allow external domains to send command to Tauri.

By default, external domains do not have access to window.__TAURI__, which means they cannot communicate with the commands defined in Rust. This prevents attacks where an externally loaded malicious or compromised sites could start executing commands on the user's device.

This configuration allows a set of external domains to have access to the Tauri commands. When you configure a domain to be allowed to access the IPC, all subpaths are allowed. Subdomains are not allowed.

WARNING: Only use this option if you either have internal checks against malicious external sites or you can trust the allowed external sites. You application might be vulnerable to dangerous Tauri command related attacks otherwise.

Csp

A Content-Security-Policy definition. See https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP.

Can be any of the following types:

  • string: The entire CSP policy in a single text string.
  • object: An object mapping a directive with its sources values as a list of strings.

CspDirectiveSources

A Content-Security-Policy directive source list. See https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/Sources#sources.

Can be any of the following types:

  • string: An inline list of CSP sources. Same as List, but concatenated with a space separator.
  • string[]: A list of CSP sources. The collection will be concatenated with a space separator for the CSP string.

DisabledCspModificationKind

The possible values for the dangerous_disable_asset_csp_modification config option.

Can be any of the following types:

  • boolean: If true, disables all CSP modification. false is the default value and it configures Tauri to control the CSP.
  • string[]: Disables the given list of CSP directives modifications.

RemoteDomainAccessScope

External command access definition.

Type: object

NameTypeDefaultDescription
scheme
string?nullThe URL scheme to allow. By default, all schemas are allowed.
domain
string(required)nullThe domain to allow.
windows
string[](required)nullThe list of window labels this scope applies to.
plugins
string[][]The list of plugins that are allowed in this scope.
enableTauriAPI
booleanfalseEnables access to the Tauri API.

UpdaterConfig

The Updater configuration object.

Type: object

NameTypeDefaultDescription
active
booleanfalseWhether the updater is active or not.
dialog
booleantrueDisplay built-in dialog or use event system if disabled.
endpoints
array?nullThe updater endpoints. TLS is enforced on production.

The updater URL can contain the following variables:
- {{current_version}}: The version of the app that is requesting the update
- {{target}}: The operating system name (one of linux, windows or darwin).
- {{arch}}: The architecture of the machine (one of x86_64, i686, aarch64 or armv7).

# Examples
- "https://my.cdn.com/latest.json": a raw JSON endpoint that returns the latest version and download links for each platform.
- "https://updates.app.dev/{{target}}?version={{current_version}}&arch={{arch}}": a dedicated API with positional and query string arguments.
pubkey
stringnullSignature public key.
windows
UpdaterWindowsConfigviewThe Windows configuration for the updater.

UpdaterEndpoint

A URL to an updater server.

The URL must use the https scheme on production.

Type: string (format: uri)

UpdaterWindowsConfig

The updater configuration for Windows.

Type: object

NameTypeDefaultDescription
installerArgs
string[][]Additional arguments given to the NSIS or WiX installer.
installMode
WindowsUpdateInstallModeviewThe installation mode for the update on Windows. Defaults to passive.

WindowsUpdateInstallMode

Install modes for the Windows update.

Can be any ONE of the following types:

  • "basicUi": Specifies there's a basic UI during the installation process, including a final dialog box at the end.
  • "quiet": The quiet mode means there's no user interaction required. Requires admin privileges if the installer does (WiX).
  • "passive": Specifies unattended mode, which means the installation only shows a progress bar.

SystemTrayConfig

Configuration for application system tray icon.

Type: object

NameTypeDefaultDescription
iconPath
string(required)nullPath to the default icon to use on the system tray.
iconAsTemplate
booleanfalseA Boolean value that determines whether the image represents a template image on macOS.
menuOnLeftClick
booleantrueA Boolean value that determines whether the menu should appear when the tray icon receives a left click on macOS.
title
string?nullTitle for MacOS tray

BuildConfig

The Build configuration object.

Type: object

NameTypeDefaultDescription
runner
string?nullThe binary used to build and run the application.
devPath
AppUrlviewThe path to the application assets or URL to load in development.

This is usually an URL to a dev server, which serves your application assets with live reloading. Most modern JavaScript bundlers provides a way to start a dev server by default.

See vite, Webpack DevServer and sirv for examples on how to set up a dev server.
distDir
AppUrlviewThe path to the application assets or URL to load in production.

When a path relative to the configuration file is provided, it is read recursively and all files are embedded in the application binary. Tauri then looks for an index.html file unless you provide a custom window URL.

You can also provide a list of paths to be embedded, which allows granular control over what files are added to the binary. In this case, all files are added to the root and you must reference it that way in your HTML files.

When an URL is provided, the application won't have bundled assets and the application will load that URL by default.
beforeDevCommand
BeforeDevCommand?viewA shell command to run before tauri dev kicks in.

The TAURI_PLATFORM, TAURI_ARCH, TAURI_FAMILY, TAURI_PLATFORM_VERSION, TAURI_PLATFORM_TYPE and TAURI_DEBUG environment variables are set if you perform conditional compilation.
beforeBuildCommand
HookCommand?viewA shell command to run before tauri build kicks in.

The TAURI_PLATFORM, TAURI_ARCH, TAURI_FAMILY, TAURI_PLATFORM_VERSION, TAURI_PLATFORM_TYPE and TAURI_DEBUG environment variables are set if you perform conditional compilation.
beforeBundleCommand
HookCommand?viewA shell command to run before the bundling phase in tauri build kicks in.

The TAURI_PLATFORM, TAURI_ARCH, TAURI_FAMILY, TAURI_PLATFORM_VERSION, TAURI_PLATFORM_TYPE and TAURI_DEBUG environment variables are set if you perform conditional compilation.
features
array?nullFeatures passed to cargo commands.
withGlobalTauri
booleanfalseWhether we should inject the Tauri API on window.__TAURI__ or not.

AppUrl

Defines the URL or assets to embed in the application.

Can be any of the following types:

  • WindowUrl: The app's external URL, or the path to the directory containing the app assets.
  • string[]: An array of files to embed on the app.

BeforeDevCommand

Describes the shell command to run before tauri dev.

Can be any of the following types:

  • string: Run the given script with the default options.
  • object: Run the given script with custom options.

HookCommand

Describes a shell command to be executed when a CLI hook is triggered.

Can be any of the following types:

  • string: Run the given script with the default options.
  • object: Run the given script with custom options.

PluginConfig

The plugin configs holds a HashMap mapping a plugin name to its configuration object.

Type: object