What is OctoPrint Tunneling?
OctoPrint Tunneling is a secure way to access the full OctoPrint UI even when you are not on your home network.
The Spaghetti Detective provides the access to the most critical functions - webcam feed, pause/cancel, changing heater temperature, etc. However, we understand there are times when you want to access other OctoPrint functions while you are not home, such as using its PSU plugin to turn on/off power supply to your printer.
So we built OctoPrint Tunneling to make it possible for you. 🚀🚀🚀
Is OctoPrint Tunneling secure?
The answer to this question is a resounding YES!
We understand the security is you ultimate consideration. Therefore we have built The Spaghetti Detective from ground up with the security as a cornerstone.
Unlike port forwarding, your OctoPrint is never exposed to the wild internet when you access it via TSD's OctoPrint Tunneling. Instead, your OctoPrint page is loaded through an SSL-encrypted tunnel. Nobody can access that tunnel without your TSD account email and password (you didn't share them with anyone did you?).
How do I access OctoPrint Tunneling?
Make sure you have upgraded the plugin to version 1.4.0 or higher.
In the printer menu, select "Tunneling".
Is OctoPrint Tunneling free to all users?
Yes and No. All users can use OctoPrint Tunneling function. However, if you have a Free account, you are limited to tunneling up to 15MB per month. Once you have reached your monthly limit, you won't be able to tunnel to OctoPrint any more until your usage is reset at the beginning of the next month.
The Pro plan subscribers get unlimited tunneling.
Why is the limit on Free account only 15MB?
We know 15MB is not a lot. The reason why we can't make this cap very high is because we need to temporarily store these data in our high-speed server cache, which is very expensive. In addition, any OctoPrint data tunneled through The Spaghetti Detective servers has to be replicated 4 times. So 15MB data actually means we are charged for 60MB by our cloud provider.
The good news is we have optimized our tunneling so that, for any file that has been downloaded to and cached in your browser, you won't need to download again. Therefore, although it'll cost a good chunk of your Free limit when you tunnel to your OctoPrint for the first time, subsequent uses of the tunneling won't take nearly as much. 15MB is sufficient to load OctoPrint 5 to 10 times via the tunnel, which should be good enough for most users in a month. If you need to tunnel to OctoPrint frequently, your best option is to upgrade to The Spaghetti Detective Pro plan and enjoy unlimited tunneling.
Why does it take so long to load the OctoPrint page in the Tunnel?
This is because, instead of directly loading into your browser, the OctoPrint page has to travel a very long distance through the tunnel.
This is obviously different from other ways to directly access OctoPrint, such as port forwarding, that may expose the traffic to malicious attackers. This is the cost we have to pay to make sure your OctoPrint stays home safely and not catches any virus (literally and metaphorically).
The first time when you use OctoPrint Tunneling, it will be particularly slow because nothing is cached in your browser. However, subsequent uses should be a lot faster since most parts of the OctoPrint page have already been cached.
Please let us know if OctoPrint Tunneling takes longer than 2 minutes to load on its first time, or longer than 30 seconds on the subsequent uses.
I got "Webcam stream not loaded" error in OctoPrint!
We have disabled tunneling webcam feed in OctoPrint. The reason for that is OctoPrint uses mjpeg, a very inefficient streaming protocol that takes a lot of bandwidth. We simply can't afford to tunnel this volume of data via our servers.
We urge you to use TSD's webcam feed instead.