If your client or launcher is not launching or is misbehaving, try one of the steps below to try to resolve the issue. Also make sure to check logs for presence of any Exception or ERROR:.

To find logs, do one of the following things:

• Open the screenshot directory (if you have access to client by right-clicking "Camera" button) and navigate 1 directory up and then open logs folder
• Navigate to %userprofile%\.sanlite\logs on Windows or $HOME/.sanlite/logs on Linux and macOS.

• Client not launching
• Problems with accessing API
• Launcher immediately closing
• Settings being reset
• Client freezing
• Client closing when loading
• FPS problems, screen flickering or artifacts
• Client .dmg or .app not opening on macOS
• Client bouncing up and down in macOS tray
• Corrupt image on macOS
• Client stuck at "Loaded update list" on Linux
• Client not launching on Linux
• PulseAudio forcibly taken over by client
• Client crashing on login
• java.net.ProtocolException on Mac OSX

If Launcher.log only displays launcher version and setting hardware accel type

• Windows 10 update KB4515384 is known to cause issues with Java applications, try uninstalling it
• RivaTuner Statistics apparently also causes this so try disabling that, related issue here.

If you see error fetching bootstrap in launcher.log you are unable to connect to SanLite servers to get the bootstrap for startup. The error will be accompanied by an exception

• ConnectException: Connection timed out - this is caused by either a firewall blocking the connection or a routing issue, try adding an exception in your firewall for SanLite, reseting/changing your current network, or use a VPN.
• IOException: Server returned HTTP response code: 403 - this means the server has seen your request but is denying you, in our case that would be GitHub intentionally blocking your connection for whatever reason. Try changing networks, using a VPN, or contacting GitHub to ask why you are getting blocked.
• SSLHandshakeException: Received fatal alert: handshake_failure - this is caused by java certs not matching refer to Problems with accessing API or downgrade your java version to 8
• SignatureException: Signature length not correct: got 0 but was expecting 512 - this is caused by your router or some other software middle manning the connection to the SanLite server, try logging into your router to disable that "feature" or contact your isp to ask what they are doing.

If you see Error loading RS! in the client.log you are unable to get the osrs client from jagex. The error will be accompanied by an exception

• SocketTimeoutException: timeout - this means the connection took too long to either connect or receive any data, most of the time caused by a slow or inconsistent internet connection, you can try resetting your network or maybe using a VPN.

If you see SSLException in client.log this probably means that you do not have your Java certificates properly set-up. Workaround is here. TLDR:

printf '\xfe\xed\xfe\xed\x00\x00\x00\x02\x00\x00\x00\x00\xe2\x68\x6e\x45\xfb\x43\xdf\xa4\xd9\x92\xdd\x41\xce\xb6\xb2\x1c\x63\x30\xd7\x92' | sudo tee /etc/ssl/certs/java/cacerts
sudo /var/lib/dpkg/info/ca-certificates-java.postinst configure

Related issue is here.

If you see ConnectionException in launcher.log this most likely means that launcher is trying to use Ipv6 instead of Ipv4 when connecting to SanLite repository.

If you see something like IllegalArgumentException: Malformed \uxxxx in client.log and your client is not launching (launcher closing immediately but nothing opens) open %userprofile%\.sanlite\settings.properties on Windows or $HOME/.sanlite/settings.properties on macOS and Linux and check if it contains weird \u0000 symbols at bottom. If yes, delete them and save the file.

A Java bug can result in freezes when users are using the All Platform version of SanLite (.jar) with Java 10. Try using Java 8, or Java 11 and newer. Related issue is here.

Ubuntu 18.04 users should install openjdk-8-jre. Arch Linux users should install jre8-openjdk or jre-openjdk.

This looks like corrupted jagex cache issue. Try to delete %userprofile%\jagexcache on Windows or $HOME/jagexcache on macOS and Linux.

Be sure to check out this guide on how to disable Hardware Acceleration.

If .dmg or .app is not opening when double clicked (because of unknown publisher or some other issue) try right-click open.

This is caused by missing software for OpenGL in your system. You can either disable hardware acceleration or install required software.

To install the software, open your terminal and install homebrew (https://brew.sh/) and then type:

brew install glfw3
brew install glew

Now client should launch properly. Related issue is here.

Use the "Jar download" from the official SanLite discord.

This is caused by PulseAudio not being supported for Java. A workaround for this is to use Alsa instead. This can be done by adding the following line to the sound.properties file which is located at $JAVA_HOME/conf/sound.properties:

javax.sound.sampled.Clip=com.sun.media.sound.DirectAudioDeviceProvider
javax.sound.sampled.Port=com.sun.media.sound.PortMixerProvider
javax.sound.sampled.SourceDataLine=com.sun.media.sound.DirectAudioDeviceProvider
javax.sound.sampled.TargetDataLine=com.sun.media.sound.DirectAudioDeviceProvider

Your JAVA_HOME is by default located at /usr/lib/jvm/.

This looks like bug with JDK 10+. The solution is either to downgrade to JDK 8 (or 9) or to delete /usr/lib/jvm/java-11-openjdk-amd64/conf/accessibility.properties (for JDK 11 on Ubuntu, for 10 the path should be similar). See related issue and related JDK bug.

If SanLite is taking over your entire PulseAudio, then you're likely missing "pulseaudio-alsa". Getting that package should resolve any sound conflicts, you can now listen to sounds and play music on your browser again.

This is probably related to some versions of the vanilla client, there are few possible solutions

• Login to vanilla (OSRS) client and move (try teleporting to Lumbridge for example) and then login back to SanLite
• Try installing the 32-bit version instead of the 64-bit version
• Try running the .jar (all platforms) version with latest Java version
• See Client closing when loading

This is caused by having SOCKS proxy enabled on your network settings

Delete the accessibility.properties file in your home directory (this is found at C:/Users/<user>/ or %userprofile%)

If your mouseover tooltips are misaligned, confirm whether or not you are using a RuneLite Account, and then follow the appropriate steps:

1. Close SanLite.
2. Open the Windows Powershell application and run the following:

Invoke-webrequest -Method DELETE -Uri ("https://api.runelite.net/runelite-" + (Invoke-Webrequest -Method GET -Uri "https://static.runelite.net/bootstrap.json" | ConvertFrom-Json).client.version + "/config/runelite.TooltipOverlay_preferredPosition") -Headers @{ 'RUNELITE-AUTH' = (Get-Content -Raw -Path $env:userprofile\.runelite\session | ConvertFrom-Json).uuid }

3. Reopen SanLite.

1. Close SanLite.
2. Open the Windows PowerShell application and run the following:

(Get-Content $env:userprofile\.runelite\settings.properties) -notmatch "runelite.TooltipOverlay_preferredPosition" | Set-Content $env:userprofile\.runelite\settings.properties

3. Reopen SanLite.