Skip to main content
Chemistry LibreTexts

4: PiTunnel

  • Page ID
  • \( \newcommand{\vecs}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \)

    \( \newcommand{\vecd}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash {#1}}} \)

    \( \newcommand{\id}{\mathrm{id}}\) \( \newcommand{\Span}{\mathrm{span}}\)

    ( \newcommand{\kernel}{\mathrm{null}\,}\) \( \newcommand{\range}{\mathrm{range}\,}\)

    \( \newcommand{\RealPart}{\mathrm{Re}}\) \( \newcommand{\ImaginaryPart}{\mathrm{Im}}\)

    \( \newcommand{\Argument}{\mathrm{Arg}}\) \( \newcommand{\norm}[1]{\| #1 \|}\)

    \( \newcommand{\inner}[2]{\langle #1, #2 \rangle}\)

    \( \newcommand{\Span}{\mathrm{span}}\)

    \( \newcommand{\id}{\mathrm{id}}\)

    \( \newcommand{\Span}{\mathrm{span}}\)

    \( \newcommand{\kernel}{\mathrm{null}\,}\)

    \( \newcommand{\range}{\mathrm{range}\,}\)

    \( \newcommand{\RealPart}{\mathrm{Re}}\)

    \( \newcommand{\ImaginaryPart}{\mathrm{Im}}\)

    \( \newcommand{\Argument}{\mathrm{Arg}}\)

    \( \newcommand{\norm}[1]{\| #1 \|}\)

    \( \newcommand{\inner}[2]{\langle #1, #2 \rangle}\)

    \( \newcommand{\Span}{\mathrm{span}}\) \( \newcommand{\AA}{\unicode[.8,0]{x212B}}\)

    \( \newcommand{\vectorA}[1]{\vec{#1}}      % arrow\)

    \( \newcommand{\vectorAt}[1]{\vec{\text{#1}}}      % arrow\)

    \( \newcommand{\vectorB}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \)

    \( \newcommand{\vectorC}[1]{\textbf{#1}} \)

    \( \newcommand{\vectorD}[1]{\overrightarrow{#1}} \)

    \( \newcommand{\vectorDt}[1]{\overrightarrow{\text{#1}}} \)

    \( \newcommand{\vectE}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash{\mathbf {#1}}}} \)

    \( \newcommand{\vecs}[1]{\overset { \scriptstyle \rightharpoonup} {\mathbf{#1}} } \)

    \( \newcommand{\vecd}[1]{\overset{-\!-\!\rightharpoonup}{\vphantom{a}\smash {#1}}} \)

    What is PiTunnel

    PiTunnel is a service that allows you remote access to your Raspberry Pi. If you’re using PiTunnel you don’t have to know the IP address. To use PiTunnel you need to have VNC Viewer installed on your computer.   


    Initial Setup

    1.    Go to

    2.    Click “Sign up Free” in the top right corner

    Figure \(\PageIndex{1}\): Create your acoount

    3.    Enter your information and join

    4.    Follow the Setup steps

    5.    After setup is complete you should see something like this:

    Figure \(\PageIndex{2}\): Devices connected to your PiTunnel account


    Custom Tunnel

    You can add a custom tunnel to your PiTunnel account. Custom tunnel will allow you to access your Raspberry Pi through VNC Viewer. You can give access to your Raspberry Pi to other people by sharing the PiTunnel address.

    1.    Navigate to “Custom Tunnels”

    Figure \(\PageIndex{3}\): Click "Custom Tunnels"

    2.    Click “Create Custom Tunnel”

    Figure \(\PageIndex{4}\): Create new custom tunnel

    3.    Enter Tunnel Name that describes the Pi you want to connect to. Enter 5900 as your local port number. Copy the command below

    Figure \(\PageIndex{5}\): Enter required information and copy the command

    4.    Open crontab on your Raspberry Pi by typing the following

    crontab -e

    5. Go to the very bottom of the document and type

    @reboot /usr/local/bin/pitunnel --port=5900 --name=home

     Replace the last part (pitunnel --port=5900 --name=home) with the command you copied from the PiTunnel website.

    6. Save the file (CTRL+O). Don't change the name when it asks you about it, just hit "Enter".

    7. Close the file (CTRL+X)

    8. To properly close the terminal type


    9. Reboot your Pi

    10. When your Pi is back on, return to your PiTunnel account and look for the custom tunnel.

    Figure \(\PageIndex{6}\): Custom tunnel address


    Using VNC with PiTunnel

    1. Open VNC Viewer

    2. Create new connection (Right-click on any open space --> New Connection)

    3. Go to your PiTunnel Account and copy the address of your custom tunnel (See Image above --> "Available At")

    4. Paste the address as VNC Server

    Figure \(\PageIndex{7}\): New Connection with PiTunnel

    5. Everything else will be just like a regular VNC connection.

    Contributors and Attributions

    • Elena Lisitsyna 

    This page titled 4: PiTunnel is shared under a not declared license and was authored, remixed, and/or curated by Robert Belford.

    • Was this article helpful?