my-project-public

repository

loading code, commits, and activity

repositories

loading repo index

#1	---
#2	description: How to spawn a SolanaOS Gateway and connect headless nodes
#3	---
#4
#5	# SolanaOS Gateway + Node Workflow
#6
#7	## Prerequisites
#8
#9	Ensure the following tools are installed:
#10	- `tmux` — `brew install tmux`
#11	- `tailscale` — https://tailscale.com/download
#12	- `solanaos` — `npm install -g solanaos`
#13	- `go` — https://go.dev/dl/
#14
#15	## Build SolanaOS
#16
#17	// turbo
#18	```bash
#19	cd /Users/8bit/Downloads/nanosolana-go && go build -ldflags="-s -w" -o build/solanaos .
#20	```
#21
#22	## Spawn the Gateway (Quick)
#23
#24	### Option A: Via SolanaOS CLI
#25
#26	// turbo
#27	```bash
#28	solanaos node gateway-spawn
#29	```
#30
#31	This will:
#32	1. Check for tmux, solanaos, and tailscale
#33	2. Detect your Tailscale IP
#34	3. Start `solanaos gateway` in a detached tmux session
#35	4. Print connection info for remote nodes
#36
#37	### Option B: Via Shell Script
#38
#39	// turbo
#40	```bash
#41	./scripts/gateway-spawn.sh
#42	```
#43
#44	Same result, but works without building SolanaOS first.
#45
#46	## Pair a Node
#47
#48	From the hardware device (Orin Nano, RPi, etc.), run:
#49
#50	```bash
#51	solanaos node pair --bridge <TAILSCALE_IP>:18790 --display-name "My Orin Nano"
#52	```
#53
#54	Then approve from the gateway host:
#55	```bash
#56	solanaos nodes approve <requestId>
#57	```
#58
#59	## Run the Node
#60
#61	```bash
#62	solanaos node run --bridge <TAILSCALE_IP>:18790
#63	```
#64
#65	## Auto-Spawn at Daemon Launch
#66
#67	To make the daemon automatically spawn a gateway at startup:
#68
#69	```bash
#70	GATEWAY_AUTO_SPAWN=true solanaos daemon
#71	```
#72
#73	Or set in `.env`:
#74	```
#75	GATEWAY_AUTO_SPAWN=true
#76	GATEWAY_SPAWN_PORT=18790
#77	GATEWAY_USE_TAILSCALE=true
#78	```
#79
#80	## Manage the Gateway
#81
#82	// turbo
#83	```bash
#84	# Check status
#85	./scripts/gateway-spawn.sh --status
#86
#87	# Kill the gateway
#88	solanaos node gateway-kill
#89
#90	# Or via script
#91	./scripts/gateway-spawn.sh --kill
#92
#93	# Attach to see gateway logs
#94	tmux attach -t solanaos-gw
#95	```
#96
#97	## Cross-Compile for Hardware
#98
#99	```bash
#100	# Raspberry Pi (ARM64)
#101	GOOS=linux GOARCH=arm64 go build -ldflags="-s -w" -o build/solanaos-linux-arm64 .
#102
#103	# NVIDIA Orin Nano (ARM64)
#104	GOOS=linux GOARCH=arm64 go build -ldflags="-s -w" -o build/solanaos-orin .
#105	```
#106
#107	## Termius SSH Workflow
#108
#109	1. Add your Tailscale host in Termius (use Tailscale IP)
#110	2. SSH in and run: `solanaos node gateway-spawn`
#111	3. From a second Termius tab: `solanaos node run --bridge <IP>:18790`
#112

z6Mkq5mY3JWtxoxUobWcfNHm7AkRubgSWEZTkBVqZXJviFZ5/my-project-public