Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Troubleshooting Issues

If there are any undocumented issues, feel free to create an issue to update the documentation!

Can’t open Settings / Manager

To open Vinegar’s settings page, you have to right click on Vinegar’s desktop entry in your application launcher, or type “Manage”. Otherwise, it will vary depending on your launcher.

You may run the manager from the CLI (discouraged):

flatpak run org.vinegarhq.Vinegar manage
# Or if from a source installation:
vinegar manage

Studio crashing upon startup with unexpected crash / corruption

This is due to a Wine bug when you upgrade Vinegar. To workaround this, simply delete all data in Vinegar’s settings; Ensure you have your Studio settings backed up! These can be found by pressing ‘Open Files’ next to the main run button, and going to: drive_c/users/<user>/AppData/Local/Roblox. The user steamuser might be present, which is from Vinegar’s past usage of Proton, which you must move or backup to your new user.

Can’t dock plugin windows

This issue occurs both on Wayland and X11-based desktop environments. You may enable Virtual Desktop in Vinegar’s settings or untick the “Allow the window manager to control the windows” option in the Advanced Wine Settings to mitigate this.

Wine’s native Wayland driver currently doesn’t support this functionality and therefore doesn’t offer a solution.

Cursor fails to lock when moving around the camera

This is an issue with Xwayland, which only allows the cursor to lock when its invisible.

This can be fixed by either:

  • Using Kombucha (automatically pulled by Vinegar)
  • Switching to an X11 session

Exit status 53

Open the Vinegar settings, then click the three dots, then click “Uninstall Studio”.

WebView Installer or Roblox Studio is missing, corrupt or doesn’t run

WebView or Studio’s downloads or installation has been corrupt.

  • For WebView, Press ‘Clear Cache’ in Vinegar’s menu within the settings page.
  • For Studio, Press ‘Uninstall Studio’ next to the main run button.

Files inaccessible or missing from file dialog (import/export)

Use Flatseal to expose specific files or run flatpak --user override --filesystem=home org.vinegarhq.Vinegar to expose your Linux home directory to Vinegar. When using the file explorer, expand the / and then expand home.

Unable to log in

There are currently two ways to login to Roblox Studio, being either from the browser or using the login dialog. The login dialog depends on ‘Web Pages’ being enabled in Vinegar’s setings, which may be a simple black screen, to fix that, you must disable it.

For browser login, follow the on-screen prompt and click “Log in via browser”. This will open Roblox’s authentication page in your default browser. Afterwards, You may be prompted to allow the use of the roblox-studio-auth protocol. Make sure to say “yes”.

If clicking on the “Log in via browser” button doesn’t do anything or/and these logs appear in Vinegar:

Failed to call portal: GDBus.Error:org.freedesktop.DBus.Error.UnknownMethod: No such interface “org.freedesktop.portal.OpenURI” on object at path /org/freedesktop/portal/desktop

You must install the xdg-desktop-portal-gtk package, the name may differ on some distributions, then reboot your system.

You may also need to give an environment variable to Vinegar for the login to work: flatpak --user override --env XDG_DESKTOP_PORTAL_BACKEND=gtk org.vinegarhq.Vinegar

If all steps were followed correctly, studio should automatically log into your account.

If you’re still unable to log in, try changing your DNS to a viable alternative such as 1.1.1.1 or 8.8.8.8. Studio authentication is known to be broken with certain DNS providers.

UI elements look small

Open the wine configurator by pressing on the cog icon next to the Wine section in Vinegar’s settings and going to the graphics section to find the DPI settings.

“Your GPU is incompatible” / “Necessary graphics drivers not installed” error

Make sure your drivers are installed correctly, if that doesn’t help you can:

  • Disable DXVK in Vinegar’s settings, and change the renderer to Vulkan or D3D11.
  • Use the Vinegar Flatpak

No Roblox desktop entries/shortcuts

This issue has no known cause, but appears to be more frequent with the Vinegar Flatpak. Rebooting your system should fix it.

Studio not working when offloaded to an Nvidia GPU (hybrid graphics)

This appears to be an issue with both the Nvidia drivers and Flatpak.

To solve this, either run the following command or switch to a non-Flatpak package of Vinegar.

flatpak --user override --nosocket=wayland org.vinegarhq.Vinegar