Vish/homelab-optimized

Fork 0

Files

Gitea Mirror Bot be94a09bf9

Documentation / Deploy to GitHub Pages (push) Has been cancelled

Details

Documentation / Build Docusaurus (push) Has been cancelled

Details

Sanitized mirror from private repository - 2026-04-05 09:32:56 UTC

2026-04-05 09:32:56 +00:00

12 KiB

Raw Blame History

🎮 NVIDIA Shield TV Pro 4K - Travel Device Configuration

🟢 Beginner to Intermediate Guide

The NVIDIA Shield TV Pro serves as a portable homelab access point, providing secure connectivity to your infrastructure while traveling. This guide covers setup, configuration, and usage scenarios.

📱 Device Overview

Hardware Specifications

Model: NVIDIA Shield TV Pro (2019)
CPU: NVIDIA Tegra X1+ (8-core, 64-bit ARM)
GPU: 256-core NVIDIA GPU
RAM: 3GB LPDDR4
Storage: 16GB eMMC + microSD expansion
Network: Gigabit Ethernet + 802.11ac WiFi
Ports: 2x USB 3.0, HDMI 2.0b, microSD slot
Power: 20W external adapter
Remote: Voice remote with backlit buttons
AI Upscaling: NVIDIA AI upscaling to 4K

Travel Use Cases

Scenario	Primary Function	Homelab Integration
Hotel Room	Media streaming, secure browsing	Plex/Jellyfin via Tailscale
Airbnb/Rental	Personal entertainment system	Full homelab access
Family Visits	Share media with family	Stream personal library
Business Travel	Secure work environment	VPN gateway to homelab
Extended Travel	Portable home setup	Complete service access

🔧 Initial Setup & Configuration

Step 1: Basic Android TV Setup

# Initial device setup
1. Connect to power and HDMI display
2. Follow Android TV setup wizard
3. Sign in with Google account
4. Connect to WiFi network
5. Complete initial updates
6. Enable Developer Options:
   - Settings > Device Preferences > About
   - Click "Build" 7 times to enable Developer Options
   - Settings > Device Preferences > Developer Options
   - Enable "USB Debugging"

Step 2: Enable Sideloading

# Allow installation of non-Play Store apps
1. Settings > Device Preferences > Security & Restrictions
2. Enable "Unknown Sources" for apps you trust
3. Or enable per-app when installing Tailscale

Step 3: Install Essential Apps

# Core applications for homelab integration
1. Tailscale (sideloaded)
2. Plex (Play Store)
3. VLC Media Player (Play Store)
4. Chrome Browser (Play Store)
5. Termux (Play Store) - for SSH access
6. Solid Explorer (Play Store) - file management

🌐 Tailscale Configuration

Installation Process

# Method 1: Direct APK Installation (Recommended)
1. Download Tailscale APK from official website
2. Transfer to Shield via USB drive or network
3. Install using file manager
4. Grant necessary permissions

# Method 2: ADB Installation (Advanced)
# From computer with ADB installed:
adb connect [shield-ip-address]
adb install tailscale.apk

Tailscale Setup

# Initial configuration
1. Open Tailscale app
2. Sign in with your Tailscale account
3. Authorize the device in Tailscale admin console
4. Verify connection to homelab network
5. Test connectivity to homelab services

# Verify connection
# From Termux or ADB shell:
ping atlantis.vish.local
ping 100.83.230.112  # Atlantis Tailscale IP

Advanced Tailscale Configuration

# Configure as exit node (optional)
# Allows Shield to route all traffic through homelab
1. Tailscale admin console > Machines
2. Find NVIDIA Shield device
3. Enable "Exit Node" capability
4. On Shield: Settings > Use as Exit Node

# Subnet routing (if needed)
# Allow access to local networks at travel location
tailscale up --advertise-routes=192.168.1.0/24

📺 Media Streaming Configuration

Plex Client Setup

# Optimal Plex configuration for travel
1. Install Plex app from Play Store
2. Sign in with Plex account
3. Server should auto-discover via Tailscale
4. If not found manually add:
   - Server IP: atlantis.vish.local
   - Port: 32400
   - Or Tailscale IP: 100.83.230.112:32400

# Quality settings for travel:
# Settings > Video Quality
# - Home Streaming: Maximum (if good WiFi)
# - Remote Streaming: 4 Mbps 720p (for limited bandwidth)
# - Allow Direct Play: Enabled
# - Allow Direct Stream: Enabled

Alternative Media Apps

# Jellyfin (if preferred over Plex)
1. Install Jellyfin app from Play Store
2. Add server: calypso.vish.local:2283
3. Or Tailscale IP: 100.103.48.78:2283

# VLC for direct file access
1. Network streams via SMB/CIFS
2. Direct file playback from NAS
3. Supports all media formats

🔒 Security & VPN Configuration

Secure Browsing Setup

# Use Shield as secure gateway
1. Configure Tailscale as exit node
2. All traffic routes through homelab
3. Benefits from Pi-hole ad blocking
4. Secure DNS resolution

# Chrome browser configuration:
# - Set homepage to homelab dashboard
# - Bookmark frequently used services
# - Enable sync for consistent experience

SSH Access to Homelab

# Using Termux for SSH connections
1. Install Termux from Play Store
2. Update packages: pkg update && pkg upgrade
3. Install SSH client: pkg install openssh
4. Generate SSH key: ssh-keygen -t ed25519
5. Copy public key to homelab hosts

# Connect to homelab:
ssh admin@atlantis.vish.local
ssh user@homelab-vm.vish.local
ssh pi@concord-nuc.vish.local

🏨 Travel Scenarios & Setup

Hotel Room Setup

# Quick deployment in hotel room
1. Connect Shield to hotel TV via HDMI
2. Connect to hotel WiFi
3. Launch Tailscale (auto-connects)
4. Access homelab services immediately
5. Stream personal media library

# Hotel WiFi considerations:
# - May need to accept terms via browser
# - Some hotels block VPN traffic
# - Use mobile hotspot as backup

Airbnb/Rental Property

# Extended stay configuration
1. Connect to property WiFi
2. Set up Shield as primary entertainment
3. Configure TV settings for optimal experience
4. Share access with travel companions
5. Use as work environment via homelab

# Family sharing:
# - Create guest Plex accounts
# - Share specific libraries
# - Monitor usage via Tautulli

Mobile Hotspot Integration

# Using phone as internet source
1. Enable mobile hotspot on phone
2. Connect Shield to hotspot WiFi
3. Monitor data usage carefully
4. Adjust streaming quality accordingly

# Data-conscious settings:
# - Plex: 2 Mbps 480p for mobile data
# - Disable automatic updates
# - Use offline content when possible

🎮 Gaming & Entertainment Features

GeForce Now Integration

# Cloud gaming via NVIDIA's service
1. Install GeForce Now app
2. Sign in with NVIDIA account
3. Access Steam/Epic games library
4. Stream games at 4K 60fps (with good connection)

# Optimal settings:
# - Streaming Quality: Custom
# - Bitrate: Adjust based on connection
# - Frame Rate: 60fps preferred

Local Game Streaming

# Stream games from homelab PCs
1. Install Steam Link app
2. Discover gaming PCs on network
3. Pair with gaming systems
4. Stream games over Tailscale

# Requirements:
# - Gaming PC with Steam installed
# - Good network connection (5+ Mbps)
# - Low latency connection

Emulation & Retro Gaming

# RetroArch for classic games
1. Install RetroArch from Play Store
2. Download cores for desired systems
3. Load ROMs from homelab NAS
4. Configure controllers

# ROM access via SMB:
# - Connect to atlantis.vish.local/roms
# - Browse by system/console
# - Load directly from network storage

🔧 Advanced Configuration

Custom Launcher (Optional)

# Replace default Android TV launcher
1. Install alternative launcher (FLauncher, ATV Launcher)
2. Set as default home app
3. Customize with homelab shortcuts
4. Create quick access to services

# Homelab shortcuts:
# - Grafana dashboard
# - Portainer interface
# - Plex web interface
# - Router admin panel

Automation Integration

# Home Assistant integration
1. Install Home Assistant app
2. Connect to concord-nuc.vish.local:8123
3. Control smart home devices
4. Automate Shield behavior

# Example automations:
# - Turn on Shield when arriving home
# - Adjust volume based on time of day
# - Switch inputs automatically

File Management

# Solid Explorer configuration
1. Add network locations:
   - SMB: //atlantis.vish.local/media
   - SMB: //calypso.vish.local/documents
   - FTP: homelab-vm.vish.local:21
2. Enable cloud storage integration
3. Set up automatic sync folders

# Use cases:
# - Download files to Shield storage
# - Upload photos/videos to homelab
# - Access documents remotely

📊 Monitoring & Management

Performance Monitoring

# Monitor Shield performance
1. Settings > Device Preferences > About
2. Check storage usage regularly
3. Monitor network performance
4. Clear cache when needed

# Network diagnostics:
# - WiFi Analyzer app for signal strength
# - Speedtest app for bandwidth testing
# - Ping tools for latency checking

Remote Management

# ADB over network (advanced)
1. Enable ADB over network in Developer Options
2. Connect from computer: adb connect [shield-ip]:5555
3. Execute commands remotely
4. Install/manage apps REDACTED_APP_PASSWORD

# Useful ADB commands:
adb shell pm list packages  # List installed apps
adb install app.apk         # Install APK remotely
adb shell input keyevent 3  # Simulate home button
adb shell screencap /sdcard/screen.png  # Screenshot

🚨 Troubleshooting

Common Issues & Solutions

# Tailscale connection problems:
1. Check internet connectivity
2. Restart Tailscale app
3. Re-authenticate if needed
4. Verify firewall settings

# Plex streaming issues:
1. Check server status in homelab
2. Test direct IP connection
3. Adjust quality settings
4. Clear Plex app cache

# WiFi connectivity problems:
1. Forget and reconnect to network
2. Check for interference
3. Use 5GHz band if available
4. Reset network settings if needed

Performance Optimization

# Improve Shield performance:
1. Clear app caches regularly
2. Uninstall unused applications
3. Restart device weekly
4. Keep storage under 80% full

# Network optimization:
1. Use wired connection when possible
2. Position close to WiFi router
3. Avoid interference sources
4. Update router firmware

📋 Travel Checklist

Pre-Travel Setup

☐ Update Shield to latest firmware
☐ Update all apps
☐ Verify Tailscale connectivity
☐ Test Plex streaming
☐ Download offline content if needed
☐ Charge remote control
☐ Pack HDMI cable (if needed)
☐ Pack power adapter
☐ Verify homelab services are running
☐ Set up mobile hotspot backup

At Destination

☐ Connect to local WiFi
☐ Test internet speed
☐ Launch Tailscale
☐ Verify homelab connectivity
☐ Test media streaming
☐ Configure TV settings
☐ Set up any shared access
☐ Monitor data usage (if on mobile)

Departure Cleanup

☐ Sign out of local accounts
☐ Clear browser data
☐ Remove WiFi networks
☐ Reset any personalized settings
☐ Verify no personal data left on device
☐ Pack all accessories

🔗 Integration with Homelab Services

Service Access URLs

# Via Tailscale (always accessible):
Plex:           http://100.83.230.112:32400
Jellyfin:       http://100.103.48.78:2283
Grafana:        http://100.83.230.112:7099
Home Assistant: http://100.67.40.126:8123
Portainer:      http://100.83.230.112:9000
Router Admin:   http://192.168.1.1

# Via local DNS (when on home network):
Plex:           http://atlantis.vish.local:32400
Jellyfin:       http://calypso.vish.local:2283
Grafana:        http://atlantis.vish.local:7099

Backup & Sync

# Automatic backup of Shield data
1. Configure Syncthing on Shield (if available)
2. Sync important folders to homelab
3. Backup app configurations
4. Store in homelab for easy restore

# Manual backup process:
1. Use ADB to pull important data
2. Store configurations in homelab Git repo
3. Document custom settings
4. Create restore procedures

💡 Pro Tip: The NVIDIA Shield TV Pro is an incredibly versatile travel companion. With proper setup, it provides seamless access to your entire homelab infrastructure from anywhere in the world, making travel feel like home.

🔄 Maintenance: Update this configuration monthly and test all functionality before important trips.

12 KiB Raw Blame History