Hold up!

You may already be able to attach — try running OakenV1.exe as administrator first.

Docs

Troubleshooting Guide

Having trouble launching Oaken? Follow the steps below to resolve the most common errors.

Oaken uses Microsoft WebView2 to render its interface. If WebView2 is missing or corrupted, the executor will fail to open. Follow these steps to fix it.

WebView2 is a Microsoft component included with most modern Windows installs, but it may be missing on fresh or stripped-down systems.

1
Open your browser and go to the official Microsoft WebView2 download page.
2
Download the Evergreen Bootstrapper installer and run it. This is the recommended version.
Download WebView2 Runtime
3
After the install finishes, restart your PC and launch Oaken again.
4
If the error persists, open Settings → Apps → Installed Apps, search for WebView2, uninstall it, then re-install using the link above.

Do not use third-party WebView2 installers. Only download from the official Microsoft link above.

SSL errors usually mean Windows Security or your antivirus removed a required file, or Oaken didn't have enough permissions to write that file in the first place.

Your antivirus may have silently quarantined a critical .exe or .txt file that Oaken needs.

Step 1 — Check Windows Security quarantine

1
Open Windows Security (search for it in the Start menu).
2
Navigate to Virus & threat protection.
3
Click Protection history and look for any items related to Oaken — especially any quarantined .exe or .txt files.
4
If found, click the item and choose Restore to put it back where it belongs.
5
Also check your third-party antivirus quarantine section (Malwarebytes, Bitdefender, etc.) and restore any Oaken files found there.

Step 2 — Run Oaken as Administrator

If Oaken does not have write permission it cannot create the files it needs, causing SSL errors. Running as admin fixes this.

1
Locate the Oaken .exe file on your PC.
2
Right-click the file and select Run as administrator.
3
Allow the UAC prompt. Oaken will now have the permissions it needs to write files correctly.

You must always run Oaken as administrator for the attach function to work properly.

This error is caused by Windows Security blocking Oaken. You need to disable specific protections and redownload Oaken for it to work properly.

You must have the latest Roblox Player installed unless you are getting the version mismatch error (see below).

Fix — Disable Windows Security protections

Windows Security settings showing Virus & threat protection and Firewall & network protection with red X indicators

These two boxes must show a red X:

  • Virus & threat protection — Turn off all protections inside
  • Firewall & network protection — Turn off for all network types
1
Open Windows Security (search for it in the Start menu).
2
Click Virus & threat protection, then click Manage settings and turn OFF all the toggles (Real-time protection, Cloud-delivered protection, etc.).
3
Go back and click Firewall & network protection. Turn OFF the firewall for Domain, Private, and Public networks.
4
Delete your current Oaken folder completely and redownload Oaken fresh from the website.
5
Extract the new download, right-click the Oaken .exe and select Run as administrator.

After following these steps, Oaken should launch and attach without issues. You can re-enable protections after if you want, but you may need to repeat this process after updates.

This error means the version of Roblox you have installed doesn't match the version Oaken was built for. You need to uninstall your current Roblox and install the correct previous version.

Do not update Roblox if prompted. Installing the previous version from the link below will resolve the mismatch.

1
Open Windows Settings (press Win + I).
2
Go to Apps → Installed apps (or Apps & features on Windows 10).
3
Search for Roblox, click it, and select Uninstall. Confirm when prompted.
4
Once uninstalled, go to weao.gg and download the previous supported Roblox version from there.
Open weao.gg
5
Run the installer you downloaded and let Roblox install fully before launching Oaken.

After installing the previous version, launch Oaken as administrator and attach as normal.

This error means another process on your PC is already using port 1337, which Oaken needs. You need to find that process and kill it using Command Prompt.

You must run Command Prompt as administrator, otherwise these commands will not have permission to kill the process.

1
Open Command Prompt as administrator — search for cmd in the Start menu, right-click it, and select Run as administrator.
2
Run the following command to find what is using port 1337. Look for a line that says LISTENING — the number at the end of that line is the PID you need.
netstat -ano | findstr :1337
3
Replace 1234 with the PID number you found above and run this command to confirm the process name.
tasklist /FI "PID eq 1234"

This will output something like: node.exe   1234   Console   ...

4
Now kill the process by running the command below, replacing 1234 with your actual PID. The /F flag forces termination immediately.
taskkill /PID 1234 /F

Once the process is killed, launch Oaken again and port 1337 will be free.

Still having issues?

Join our Discord server and open a support ticket. Include your error message and the steps you already tried.

Join Discord