Access your virtual private cloud (VPC)

This topic is a quick guide for setting up a Linux subnet router to access your virtual private cloud (VPC). You can also set up a subnet router on Windows or macOS. For more detailed information, see Connect to an AWS VPC using subnet routes.

Prerequisites

You need a Tailscale account.
You need a Linux VM. The following topics provide details for setting up a Linux VM using common cloud providers:
You need Tailscale installed on your Linux VM.
You need Tailscale installed on your local machine.

Create a Tailscale subnet router

Start by jotting down the IP address of the private resources you want to access and determine the Classless Inter-Domain Routing (CIDR) notation that represents the subnet boundaries for those resources. For example, if you have a VM at 10.0.0.3 and another at 10.0.1.4, you might consider using CIDR notations 10.0.0.0/24 and 10.0.1.0/24 to represent these subnets

Cloud providers may also provide CIDR address spaces for your VPCs which you can just use out of the box. For example, here is a screenshot for AWS:

This is a screenshot for Azure:
Start by accessing your VM to start configuring your subnet router.

This will most likely be the cloud-provided SSH mechanism and may require you to temporarily open up port 22 on that VM to your corporate network or the internet.

In a terminal window, run the following command to see if you have sysctl.d on your system:
```
ls /etc | grep sysctl.d
```

If the command returns an output, it means sysctl.d is on your system, so you can run the following commands to set up IP forwarding on your router:

If your Linux system has a /etc/sysctl.d directory, use:

echo 'net.ipv4.ip_forward = 1' | sudo tee -a /etc/sysctl.d/99-tailscale.conf
echo 'net.ipv6.conf.all.forwarding = 1' | sudo tee -a /etc/sysctl.d/99-tailscale.conf
sudo sysctl -p /etc/sysctl.d/99-tailscale.conf

Otherwise, use:

echo 'net.ipv4.ip_forward = 1' | sudo tee -a /etc/sysctl.conf
echo 'net.ipv6.conf.all.forwarding = 1' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p /etc/sysctl.conf

If you have firewalld installed on your VM instance, you should also allow masquerading for your subnet router to work:
```
firewall-cmd --permanent --add-masquerade
```
If this command return an error that means you do not have firewalld installed and can skip to the next step.
Finally, run the tailscale set command to start advertising routes to your subnet (the routes your recorded in step 1):
```
sudo tailscale set --advertise-routes=<subnet range 1>,<subnet range 2>,...
```
Running this step will cause the VM to authenticate with Tailscale. You will be asked to login with your credentials and add the device to your tailnet. Here’s an example of running the command with the subnet ranges we used in step 1:
```
sudo tailscale set --advertise-routes=10.0.0.0/24,10.0.1.0/24
```

Open the Access Controls page of the Tailscale admin console and add the following lines to your tailnet policy file to allow connectivity via your subnet:

"acls": [
           { "action": "accept",
             "src": ["your-tailscale-username"],
             "dst": ["<subnet-range-1>/24:*","<subnet-range-2>/24:*"]
           }
        ],

This will allow the designated subnets to be reachable by you and to the ports that you designate in the rule. Here’s an example of a rule based on subnets in step 1 which allows access to all ports in the subnet range to the user john.doe@example.com:

"acls": [
        { "action": "accept",
          "src": ["john.doe@example.com"],
          "dst": ["10.0.0.0/24:*","10.0.1.0/24:*"]
        }
     ],

If you are using a Linux-based local machine (not your subnet router) to connect, you need to run the tailscale set command to accept the advertised routes. If you are not using a Linux-based local machine, you can skip this step.
```
sudo tailscale set --accept-routes
```

Use the subnet router

From step 1 in Create a Tailscale subnet router, find the private IP addresses for the resources or machine that you are trying to reach.

On your local machine, in a terminal window, ping those private IPs.

ping <your private vm ip address>

You should see responses from them which indicate that your subnet router is working as expected.

For example, using private IPs in step 1:

ping 10.0.0.3 -t 4

If successful, you should see a response from these private IP addresses similar to:

PING 10.0.0.3 (10.0.0.3): 56 data bytes
64 bytes from 10.0.0.3: icmp_seq=0 ttl=64 time=0.112 ms
64 bytes from 10.0.0.3: icmp_seq=1 ttl=64 time=0.088 ms
64 bytes from 10.0.0.3: icmp_seq=2 ttl=64 time=0.175 ms
64 bytes from 10.0.0.3: icmp_seq=3 ttl=64 time=0.145 ms