Skip to content

Commit 078ca93

Browse files
authored
Merge pull request #463 from AccelerationConsortium/copilot/fix-4e34572b-8462-4eca-bf36-1e315d9075af
Add initial device access options to Tailscale setup documentation
2 parents cd89ada + 42f8527 commit 078ca93

File tree

1 file changed

+23
-1
lines changed

1 file changed

+23
-1
lines changed

docs/tailscale-setup.md

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,29 @@ The following covers [tailscale setup](#general-setup-instructions) for general-
66

77
## General Setup Instructions
88

9-
Follow the [Bookworm tailscale installation instructions](https://tailscale.com/kb/1174/install-debian-bookworm) (or follow the appropriate device instructions at https://tailscale.com/kb/1347/installation if not using bookworm). It's convenient to SSH into the device over the same WiFi network to make copy-pasting commands into the terminal easier (rather than trying to type them out).
9+
Follow the [Bookworm tailscale installation instructions](https://tailscale.com/kb/1174/install-debian-bookworm) (or follow the appropriate device instructions at https://tailscale.com/kb/1347/installation if not using bookworm).
10+
11+
### Initial Device Access Options
12+
13+
For running commands on your device during setup, you have several options:
14+
15+
1. **Direct SSH (Same Network)**: If both your computer and the device are on the same WiFi network, you can SSH directly to the device using its local IP address. This is convenient for copy-pasting commands instead of typing them out. Find the device's IP address using:
16+
```bash
17+
# Using mDNS/Bonjour hostname (if supported):
18+
ssh pi@<hostname>.local
19+
# Example: ssh [email protected]
20+
21+
# Or using the device's local IP address:
22+
23+
# Replace 192.168.1.100 with your device's actual IP address
24+
```
25+
26+
2. **Physical Access**: Connect a keyboard and mouse directly to the device. This is especially useful when:
27+
- You don't have SSH enabled yet
28+
- You're troubleshooting network connectivity issues
29+
- You need to perform initial WiFi setup on the device (and couldn't when flashing using the Raspberry Pi Imager tool)
30+
31+
3. **Headless Setup**: For devices without displays, consider using SSH over the same network or setting up WiFi credentials via the Raspberry Pi Imager tool before first boot.
1032

1133
You can see which RPi OS version you have (assuming you're using RPi OS) [by running](https://www.cyberciti.biz/faq/linux-command-print-raspberry-pi-os-version-on-raspberry-pi/) `hostnamectl` or using `cat /etc/os-release`. However, if you're using Ubuntu OS on your RPi, you'll [need to run](https://www.google.com/search?q=check+ubuntu+version) `lsb_release -a`.
1234

0 commit comments

Comments
 (0)