Tinkerwell 4 is out now! See what's new or buy now.
Tinkerwell background image
Tinkerwell Logo Tinkerwell
Hey! You are currently looking at the documentation for Tinkerwell 2. The latest version of the documentation is available here.

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+.

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.