If you’re having persistent troubles with Craft failing to install or with the InVision Sync app not connecting or syncing properly, it could be related to use of a proxy. A proxy server acts as an intermediary between your computer and another server from which you are requesting a service (eg. accessing a website). Currently, neither Craft nor InVision Sync formally support proxies.
This document provides an overview of possible issues with Craft or InVision Sync that could occur when using a proxy and walks you through how to troubleshoot and fix them. Please note that the symptoms described below aren’t only caused by proxies. At the same time using a proxy doesn’t automatically mean that you will experience these issues. There are many different types of proxies out there and not all of them will interfere with Craft and/or InVision Sync functionality similarly.
Affected Product Areas
- Craft Manager
- Craft Plugins (especially Craft Sync)
- InVision Sync
- Sketch crashing whenever using Craft Sync
- Looking for Craft Plugins and/or Manager Updates results in error:
- Installation fails completely (there are other reasons this may occur if not caused by a proxy):
- Craft Manager window completely blank:
How do I know if I am using a Proxy?
A potential way to check if your connection is going through a proxy is to visit www.whatismyproxy.com
If you see a result similar to the screenshot below, it is unlikely a proxy is in use:
If you're using a Mac, open your System Preferences and select Network and go to Advanced in your wifi or ethernet settings (depending on which connection you are using) and select Proxies.
If any of the proxy options (eg Auto Proxy Discovery) has a checkmark next to it, it means that you are most likely using a proxy.
What do I do if I'm using a proxy and can't use Craft Sync or InVision Sync?
As mentioned above, we do not formally support proxies. So if you’ve identified you are using a proxy and it is keeping you from using InVision Sync and/or Craft, you will need to disable the proxy by removing the check marks next to any of the protocols enabled in the "Proxies" tab within Network system preferences in macOS, and then click OK & Apply. Next go ahead and try installing and running InVision Sync and/or Craft again. Please note that the proxy may have been in place on your workstation in order to allow other applications to work or may be required by your own IT/security teams, so you should consult with your IT team to see if you can disable the proxy.