Tinkerwell 4 is out now! See what's new or buy now.
Tinkerwell background image
Tinkerwell Logo Tinkerwell

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.