Skip to content

single-instance

Ensure a single instance of your app is running.

Oct 28, 2026
  • aedd883c (#3482 by @JGuest121) Release the single instance lock in AppHandle::cleanup_before_exit, right before the process exits or restarts, instead of on RunEvent::Exit. The app now remains the single instance while your own RunEvent::Exit handler runs. destroy can still release the lock earlier.
  • 6c9746e5 (#3704 by @karan5028ji) Fix race condition on Windows where a secondary instance fails to exit if FindWindowW misses the target event window during startup.
Oct 14, 2026
  • f83c5d3b (#3584 by @vincentkoc) On Linux, a secondary instance that cannot deliver its arguments to the primary instance now returns a plugin initialization error instead of exiting successfully, and an invalid dbus_id returns an error instead of panicking. When the session bus is unavailable the app keeps launching normally, without single-instance support, and logs a warning.
  • b53d1984 (#3686 by @lucasfernog) On Windows, an argument containing a | is no longer split into several arguments when it is forwarded to the running instance.
Oct 10, 2026
  • 818d2e04 (#3645) On Windows, a second instance no longer waits indefinitely for a first instance that stopped processing messages: it stops waiting after 10 seconds and exits. The first instance may still receive the arguments once it resumes processing messages.
  • 323fe80d (#3644) A second instance no longer panics when a command-line argument is not valid Unicode: such an argument is forwarded with its invalid parts replaced by U+FFFD. A working directory that is not valid Unicode is now forwarded the same way instead of as an empty string.
Oct 1, 2026
Sep 29, 2026
  • ecd3273e (#3480 by @renovate) Updated windows-rs dependencies:

    • deep-link: updated windows-registry to 0.6 and windows-result to 0.4. The public Error::Windows variant wraps windows_result::Error; applications using this type directly should update their windows-result dependency.
    • opener: updated windows to 0.62. The public Error::Win32Error variant wraps windows::core::Error; applications using this type directly should update their windows dependency.
    • single-instance: updated windows-sys to 0.61
    • updater: updated windows-sys to 0.61
Sep 26, 2026
Sep 20, 2026
  • 67cd25a1 (#3592) On Windows, the second instance now allows the first instance to bring its window to the front before exiting, so focusing a window from the callback no longer gets refused by Windows.
Aug 31, 2026
Jul 13, 2026
  • d1573877 (#3466 by @bajoca05) Fix blocked thread on the single-instance plugin for MacOS: replace standard UnixListener with tokio::net::UnixListener, so the task can yield.
May 2, 2026
Apr 4, 2026
Feb 5, 2026
  • 98e2c11e (#3194 by @mrquantumoff) Breaking Change: On Linux, the DBus ID/name will now be <bundle-id>.SingleInstance instead of org.<bundle_id_underscores>.SingleInstance to follow DBus specifications.

    This will break the single-instance mechanism across different app versions if the app was installed multiple times.

    Added dbus_id builder method, which can be used to restore previous behavior. For a bundle identifier of com.tauri.my-example this would be dbus_id("org.com_tauri_my_example").

Jan 8, 2026
Oct 27, 2025
  • 93426f85 Fixed an issue that caused docs.rs builds to fail. No user facing changes.
Oct 26, 2025
Sep 2, 2025
Aug 21, 2025
Jul 22, 2025
Jul 20, 2025
  • 6f345870 (#2860 by @MorpheusXAUT) Fix D-Bus name replacement logic on Linux to prevent multiple instances from acquiring the same well-known name.
    This patch updates the zbus dependency to the latest compatible version (^5.9) and explicitly sets RequestNameFlags to ensure a second instance fails to acquire the D-Bus name when another one is already running.
Jun 25, 2025
May 20, 2025
  • dc84f8d8 (#2609 by @Simon-Laux) fix cwd in single instance on macOS, which was the cwd of the first instance, instead of the second (like it is on windows and linux)
Apr 2, 2025
Feb 24, 2025
Jan 13, 2025
Dec 9, 2024
  • 3a79266b (#2173 by @FabianLars) Bumped all plugins to v2.2.0. From now, the versions for the Rust and JavaScript packages of each plugin will be in sync with each other.
Dec 2, 2024
Oct 3, 2024
Oct 2, 2024
  • e2c4dfb6 Update to tauri v2 stable release.
Oct 2, 2024
Sep 15, 2024
Sep 12, 2024
Sep 10, 2024
Aug 29, 2024
Aug 2, 2024

single-instance full changelog


© 2026 Tauri Contributors. CC-BY / MIT