docs: add reMarkable tablet integration guide
Full setup guide for connecting reMarkable tablets via Tailscale: - Tailscale installation (userspace networking mode) - Systemd service for auto-start - SSH configuration - Document management commands (upload/list/delete) - Troubleshooting common issues Tested on reMarkable 2, OS 3.24.0.149.
This commit is contained in:
SPANISH FLU
parent
9688454a30
commit
162025b292
175
docs/guides/remarkable-integration.md
Normal file
175
docs/guides/remarkable-integration.md
Normal file
@ -0,0 +1,175 @@
|
||||
# reMarkable Tablet Integration
|
||||
|
||||
Connect your reMarkable tablet to Clawdbot via Tailscale for direct SSH access from anywhere.
|
||||
|
||||
## Overview
|
||||
|
||||
This guide sets up:
|
||||
- Tailscale VPN on your reMarkable (userspace networking mode)
|
||||
- Direct SSH access via Tailscale IP
|
||||
- Ability to upload/manage documents remotely
|
||||
|
||||
**Tested on:** reMarkable 2, OS 3.24.0.149
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- reMarkable with SSH access enabled
|
||||
- Another computer on the same network (for initial setup)
|
||||
- Tailscale account
|
||||
|
||||
## Step 1: Get Tailscale Binaries
|
||||
|
||||
The reMarkable's root partition is small (~21MB free), so we install to `/home`.
|
||||
|
||||
```bash
|
||||
# On a computer that can reach your reMarkable
|
||||
# Download the ARM static binary
|
||||
curl -fsSL https://pkgs.tailscale.com/stable/tailscale_1.94.1_arm.tgz -o /tmp/tailscale_arm.tgz
|
||||
|
||||
# Copy to reMarkable (replace IP with yours)
|
||||
scp /tmp/tailscale_arm.tgz root@<REMARKABLE_IP>:/home/
|
||||
```
|
||||
|
||||
## Step 2: Install on reMarkable
|
||||
|
||||
SSH into your reMarkable and run:
|
||||
|
||||
```bash
|
||||
cd /home
|
||||
tar xzf tailscale_arm.tgz
|
||||
mkdir -p /home/bin /home/tailscale-state
|
||||
cp tailscale_*/tailscale tailscale_*/tailscaled /home/bin/
|
||||
chmod +x /home/bin/tailscale /home/bin/tailscaled
|
||||
```
|
||||
|
||||
## Step 3: Start Tailscale
|
||||
|
||||
The reMarkable kernel doesn't have TUN support, so we use userspace networking with `--statedir` for SSH keys:
|
||||
|
||||
```bash
|
||||
# Start the daemon
|
||||
nohup /home/bin/tailscaled \
|
||||
--statedir=/home/tailscale-state \
|
||||
--socket=/tmp/tailscaled.sock \
|
||||
--tun=userspace-networking > /tmp/tailscaled.log 2>&1 &
|
||||
|
||||
# Wait a few seconds, then authenticate
|
||||
sleep 5
|
||||
/home/bin/tailscale --socket=/tmp/tailscaled.sock up --ssh
|
||||
```
|
||||
|
||||
This will print an authentication URL. Visit it to add the reMarkable to your Tailnet.
|
||||
|
||||
## Step 4: Create Systemd Service
|
||||
|
||||
For auto-start on boot:
|
||||
|
||||
```bash
|
||||
cat > /etc/systemd/system/tailscaled.service << 'EOF'
|
||||
[Unit]
|
||||
Description=Tailscale VPN
|
||||
After=network-online.target
|
||||
Wants=network-online.target
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
ExecStart=/home/bin/tailscaled --statedir=/home/tailscale-state --socket=/tmp/tailscaled.sock --tun=userspace-networking
|
||||
ExecStartPost=/bin/sh -c 'sleep 3 && /home/bin/tailscale --socket=/tmp/tailscaled.sock up --ssh'
|
||||
Restart=on-failure
|
||||
RestartSec=5
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
EOF
|
||||
|
||||
systemctl daemon-reload
|
||||
systemctl enable tailscaled
|
||||
systemctl start tailscaled
|
||||
```
|
||||
|
||||
## Step 5: Configure SSH Client
|
||||
|
||||
On your local machine, add to `~/.ssh/config`:
|
||||
|
||||
```
|
||||
Host rem
|
||||
HostName <TAILSCALE_IP> # e.g., 100.91.182.5
|
||||
User root
|
||||
StrictHostKeyChecking no
|
||||
UserKnownHostsFile /dev/null
|
||||
```
|
||||
|
||||
Now you can simply run:
|
||||
```bash
|
||||
ssh rem
|
||||
```
|
||||
|
||||
## Document Management
|
||||
|
||||
Once SSH is configured, you can manage documents remotely.
|
||||
|
||||
### Upload PDFs/EPUBs
|
||||
|
||||
```bash
|
||||
# Copy file to reMarkable
|
||||
scp document.pdf rem:/home/root/
|
||||
|
||||
# Create metadata and add to library
|
||||
ssh rem 'cd /home/root/.local/share/remarkable/xochitl && \
|
||||
UUID=$(cat /proc/sys/kernel/random/uuid) && \
|
||||
cat > ${UUID}.metadata << EOF
|
||||
{
|
||||
"createdTime": "'$(date +%s)'000",
|
||||
"lastModified": "'$(date +%s)'000",
|
||||
"lastOpened": "0",
|
||||
"lastOpenedPage": 0,
|
||||
"parent": "",
|
||||
"pinned": false,
|
||||
"type": "DocumentType",
|
||||
"visibleName": "My Document"
|
||||
}
|
||||
EOF
|
||||
cp /home/root/document.pdf ${UUID}.pdf && \
|
||||
echo "{}" > ${UUID}.content && \
|
||||
systemctl restart xochitl'
|
||||
```
|
||||
|
||||
### List Documents
|
||||
|
||||
```bash
|
||||
ssh rem 'grep -h visibleName /home/root/.local/share/remarkable/xochitl/*.metadata'
|
||||
```
|
||||
|
||||
### Delete Documents
|
||||
|
||||
```bash
|
||||
# Find UUID by name
|
||||
ssh rem 'grep -l "Document Name" /home/root/.local/share/remarkable/xochitl/*.metadata'
|
||||
# Delete all files with that UUID
|
||||
ssh rem 'rm /home/root/.local/share/remarkable/xochitl/<UUID>.* && systemctl restart xochitl'
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "no var root for ssh keys"
|
||||
Use `--statedir=/home/tailscale-state` instead of `--state=`
|
||||
|
||||
### Connection timeouts
|
||||
The reMarkable goes to sleep aggressively. Wake it by tapping the screen.
|
||||
|
||||
### Tailscale not starting on boot
|
||||
Check logs: `journalctl -u tailscaled`
|
||||
|
||||
### No TUN support
|
||||
This is normal — the reMarkable kernel doesn't include the TUN module. Userspace networking mode works around this.
|
||||
|
||||
## Limitations
|
||||
|
||||
- **Userspace networking**: Outbound connections from reMarkable require proxy configuration
|
||||
- **Sleep mode**: The tablet sleeps frequently; connections may timeout
|
||||
- **Kernel TUN**: Not available without custom kernel (risky)
|
||||
|
||||
## References
|
||||
|
||||
- [remarkable.guide/tech/tailscale](https://remarkable.guide/tech/tailscale.html)
|
||||
- [Tailscale userspace networking](https://tailscale.com/kb/1112/userspace-networking)
|
||||
Loading…
Reference in New Issue
Block a user