Spine Troubleshooting

Having trouble running Spine? Is Spine unable to start or crashes while you are using it? You have come to the right place!

While we strive for Spine to run flawlessly on all computers, sometimes things go wrong or Spine is run on configurations that we've never seen before. On this page you'll find a number of things you can check to get Spine running.

spine.log

When Spine runs, the first thing it does is create a log file at this location:

Windows

%UserProfile%\Spine\spine.log or C:\Users\<user name>\Spine\spine.log

macOS

~/Library/Application Support/Spine/spine.log

Linux

~/.spine/spine.log

If any errors occur, they will appear in this file. Sometimes the error message is mixed with what looks like unintelligible information, so read carefully. If you can't make any sense of the errors, you can it post on the forum or send it to us. Please post or email the entire log, not just part of it (the forum will automatically remove your name and email from the log). Also, it helps a great deal to tell what you were doing when the error occurred. We love to fix bugs in Spine and are very grateful if you can help us reproduce any problem you might find.

Each time Spine runs it deletes the spine.log file and creates a new, empty one. If Spine crashes you should check the spine.log file before running Spine again.

spine.log is missing

If the spine.log file is never created, it means that something went wrong with Spine very early in Spine's start up process. You may need to run Spine from the command line:

Windows

Open Command Prompt and type: "C:\Program Files (x86)\Spine\Spine.com"

macOS

  • Open Terminal and type: /Applications/Spine/Spine.app/Contents/MacOS/Spine
  • Alternatively, on macOS you can run the Console app, choose All Messages, then start Spine and watch the output in the Console app.

Linux

Run: Spine.sh

When you run Spine this way, Spine's logging is output in the command line window and you may see errors that give clues about why Spine is unable to start.

On macOS other software may conflict with Spine. For example, screen mirroring software or Finder "enhancements", such as Default Folder X, can prevent Spine from running. Also, Rescue Time may need to be closed when Spine is started.

Antivirus and anti-malware

Some antivirus or anti-malware software, such as Bit Defender or 360 Browser, may modify or delete Spine's files. This can cause Spine to fail to run completely, or fail at a later point. You'll need to disable such software or safelist Spine's folders. Spine's folders are:

Windows

  • C:\Program Files (x86)\Spine\ (or the folder where you installed Spine)
  • %UserProfile%\Spine or <user home folder>\Spine

macOS

  • /Applications/Spine/
  • ~/Library/Application Support/Spine/

Linux

  • The folder where you decompressed and placed Spine.
  • ~/.spine/

Outdated launcher

One of the first things to check is that you are running the latest Spine launcher. To do that, go to your Spine license page which you received when you purchased Spine, then download and reinstall Spine. If you can't find your Spine license page you can use the license recovery page.

Networking

When you install Spine, you are actually installing the Spine launcher. When you run Spine, it needs to download the version of Spine you want to run. After that you can run Spine without a network connection.

Certificate expiration

Spine is unable to reach the server if you downloaded Spine before February 15, 2020 or your Spine launcher version is less than 3.8.82. Due to a certificate expiration in the old Spine installation, you will need to download and reinstall Spine. You can find the download links on your Spine license page or use the license recovery page.

Servers

Spine's servers are located in Japan, Europe, and the USA. If you are located in China or your internet connection to the servers is very slow, you may need to try multiple times, use a VPN, or try again later.

Spine automatically chooses the server with the best connection for you and if that fails it will also try every other server. Spine checks the best connection every few days, but you can force it by running Spine from the command line using --ping. You can also force it to prefer a specific server using --server jp, --server eu, or --server us.

Firewall

If you have a firewall on your router or other network hardware, or a software firewall that blocks Spine from reaching the server, then you'll need to disable the firewall or add rules to allow Spine's communication. Spine connects to *.esotericsoftware.com using ports 443 and 80.

Hosts file

Spine will be unable to run if your hosts file contains an entry that redirects network traffic for esotericsoftware.com. You'll see an error message about it in your spine.log file and you'll need to edit your hosts file to remove the entry:

Windows

C:\Windows\System32\drivers\etc\hosts

macOS and Linux

/etc/hosts

Proxy

If you require internet connections to use a proxy server, you'll need to start Spine with a special command to specify the proxy server.

Outdated audio and video drivers

Spine uses hardware accelerated audio and video (OpenAL and OpenGL). Any bugs in the drivers for your audio or video hardware can cause Spine to crash or be unable to run at all. Make sure you have the latest drivers by going to the manufacturer's website for both your audio and video hardware, then download and install the latest drivers provided.

Disable audio

If you don't need Spine's audio capabilities, you can disable Spine's use of the audio hardware by starting Spine with the --disable-audio command line parameter. We've had reports of some bad audio drivers for gaming laptops.

User files

Spine stores settings and other files in your user folder:

Windows

%UserProfile%\Spine or <user home folder>\Spine

macOS

~/Library/Application Support/Spine/

Linux

~/.spine/

You can safely delete this entire folder and everything in it. However, you may want to first save some of the files:

  • The backup subfolder is where Spine stores copies of your projects each time you save.
  • The .json files are where Spine stores your settings. Deleting them resets Spine to the default settings.
  • The hotkeys.txt file is where Spine stores the hotkeys to use for various actions. If you have customized this file, you probably want to keep a copy of it.
  • The updates subfolder is where Spine stores downloaded updates. Deleting them will cause Spine to download the updates again.

Outdated Spine version

You can choose which version of Spine to run in Spine's settings. If Spine is crashing, you may want to try the latest update. Please note that if you save your projects with a newer version, older versions won't be able to open it.

To run the latest version, choose Latest in Spine's settings. If you can't get to the settings dialog, you can delete the version.txt file here:

Windows

%UserProfile%\Spine\version.txt or <user home folder>\Spine\version.txt

macOS

~/Library/Application Support/Spine/version.txt

Linux

~/.spine/version.txt

If the file doesn't exist, then Spine will use the latest version. If the file does exist, Spine will use the version specified in the file.

You can also specify the version via the command line. First choose a version from the changelog, for example 3.7.94, then run Spine this way:

Windows

Open Command Prompt and type: "C:\Program Files (x86)\Spine\Spine.com" --update 3.7.94

macOS

Open Terminal and type: /Applications/Spine/Spine.app/Contents/MacOS/Spine --update 3.7.94

Linux

Run: Spine.sh --update 3.7.94

If you are having problems with the latest version, you can try going back to an older version (if you haven't yet saved your project with the newer version, or you get an older version of your project from your backups). We fix bugs very quickly, often within days (especially when users show us how to reproduce a problem!), but if you are having trouble with the latest version you may want to use an older version so you can be productive, rather than wait for a fix.

Still have problems?

If you have gone through the information above and you still have problems running Spine, please on the forum or contact us.