Get DevTools for Tailwind CSS with full JIT engine support directly in your browser Learn more


Common Issues

First steps#

Please double check the following steps if you encounter any issues.

  1. Make sure you have the correct PHP executable selected in the advanced settings
  2. More than 95% of SSH connection issues are rooted in a wrong private key

On MacOS and Linux, you can find the correct PHP executable by running which php in your terminal.

If you can't find a solution to your problem in this guide, please check our public repository here.

No output or PHP errors#

Make sure you have the correct PHP binary selected. This is the most common issue if you are running Tinkerwell on Windows.

SSH connection issues#

Please check your private and public key path. We track down most connection issues to a misconfiguration of key pairs at Vagrant, Homestead or the remote server. Both keys must be in the same directory.

The "passphrase" input field is for password protected keys and not for server passwords.

How to show hidden files when selecting your private key#

On macOS you can show all hidden files by pressing CMD+SHIFT+.

Tinkerwell is unresponsive, slow, doesn't start or anything else#

If Tinkerwell is broken in some way and you want to install it from scratch, make sure to delete the config files that hold your settings and all emails.


Tinkerwell stores data at:

Linux: /home/<Username>/.config/Tinkerwell
Windows: C:\Users\<Username>\AppData\Roaming\Tinkerwell
Mac: /Users/<Username>/Library/Application Support/Tinkerwell

The settings are stores in the vuex.json file. Renaming this file to something else creates a fresh version on the next app start.