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.

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 + .. Alternatively, you can navigate to the path of your SSH key by pressing CMD + SHIFT + G in Finder. Then type ~/.ssh/ and press Enter.

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, connections and caches.

Paths

#

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 stored in the vuex.json file. Renaming this file to something else creates a fresh version on the next app start.