Repository navigation
Expand file tree
/
Copy pathvps-reference.html
More file actions
214 lines (172 loc) · 8.58 KB
/
Copy pathvps-reference.html
File metadata and controls
214 lines (172 loc) · 8.58 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>VPS Reference — PocketServer Commands</title>
<style>
:root { --bg: #0d1117; --surface: #161b22; --border: #30363d; --text: #e6edf3; --text2: #8b949e; --accent: #58a6ff; --green: #3fb950; --red: #f85149; --yellow: #d29922; }
* { margin: 0; padding: 0; box-sizing: border-box; }
body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; background: var(--bg); color: var(--text); padding: 20px; max-width: 1000px; margin: 0 auto; line-height: 1.6; }
h1 { font-size: 28px; margin-bottom: 8px; }
h2 { font-size: 20px; margin: 32px 0 12px; color: var(--accent); border-bottom: 1px solid var(--border); padding-bottom: 6px; }
h3 { font-size: 16px; margin: 20px 0 8px; color: var(--green); }
p, li { font-size: 14px; color: var(--text2); margin: 4px 0; }
ul { padding-left: 20px; }
table { width: 100%; border-collapse: collapse; margin: 12px 0; }
th, td { text-align: left; padding: 8px 12px; border: 1px solid var(--border); font-size: 13px; }
th { background: var(--surface); color: var(--accent); font-weight: 600; }
td { color: var(--text); }
code { background: var(--surface); color: var(--green); padding: 2px 6px; border-radius: 4px; font-family: 'SF Mono', 'Fira Code', monospace; font-size: 13px; }
pre { background: var(--surface); border: 1px solid var(--border); border-radius: 8px; padding: 14px; margin: 8px 0; overflow-x: auto; }
pre code { background: none; padding: 0; }
.tag { display: inline-block; padding: 2px 8px; border-radius: 12px; font-size: 11px; font-weight: 600; }
.tag-running { background: #1a3a2a; color: var(--green); }
.tag-stopped { background: #3a1a1a; color: var(--red); }
.tag-info { background: #1a2a3a; color: var(--accent); }
.card { background: var(--surface); border: 1px solid var(--border); border-radius: 8px; padding: 16px; margin: 12px 0; }
.warn { border-left: 3px solid var(--yellow); padding-left: 12px; margin: 12px 0; color: var(--yellow); }
</style>
</head>
<body>
<h1>PocketServer VPS Reference</h1>
<p>Android-based server running Ubuntu 22.04 in chroot on a rooted device with Tailscale networking.</p>
<h2>Connection Info</h2>
<table>
<tr><th>Property</th><th>Value</th></tr>
<tr><td>Tailscale Hostname</td><td><code>ai-vps-goyaljai.tail98a210.ts.net</code></td></tr>
<tr><td>Tailscale IP</td><td><code>100.70.224.76</code></td></tr>
<tr><td>Public IP (via Funnel)</td><td><code>103.84.155.217</code></td></tr>
<tr><td>OS</td><td>Ubuntu 22.04 (chroot on Android)</td></tr>
<tr><td>CPU</td><td>8 cores (aarch64)</td></tr>
<tr><td>RAM</td><td>8 GB</td></tr>
<tr><td>Disk</td><td>~116 GB (64 GB free)</td></tr>
<tr><td>Chroot Path</td><td><code>/data/local/linux/rootfs</code></td></tr>
</table>
<h2>Access Methods</h2>
<h3>ADB (primary — always works)</h3>
<pre><code># Connect to device
adb devices
# Run command inside chroot
adb shell "su 0 chroot /data/local/linux/rootfs /bin/bash -c 'export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin; YOUR_COMMAND'"
# Push files to device
adb push local_file /sdcard/filename
# Copy into chroot
adb shell "su 0 cp /sdcard/filename /data/local/linux/rootfs/destination/"</code></pre>
<h3>SSH (may not work through Tailscale userspace networking)</h3>
<pre><code>ssh root@100.70.224.76
# If SSH times out, use ADB instead</code></pre>
<h3>Web Access (via Tailscale Funnel)</h3>
<pre><code># Jaika v2 (main app)
https://ai-vps-goyaljai.tail98a210.ts.net
# PocketServer Dashboard
https://ai-vps-goyaljai.tail98a210.ts.net:10000</code></pre>
<h2>Service Management (Supervisor)</h2>
<h3>Common Commands</h3>
<pre><code># Check all services
supervisorctl status
# Start/stop/restart a service
supervisorctl start jaika
supervisorctl stop jaika
supervisorctl restart jaika
# Reload configs after editing .conf files
supervisorctl reread
supervisorctl update
# View logs
tail -50 /var/log/server/jaika-out.log
tail -50 /var/log/server/jaika-err.log</code></pre>
<h3>Current Services</h3>
<table>
<tr><th>Service</th><th>Port</th><th>Status</th><th>Config</th></tr>
<tr><td>Jaika v2</td><td>5244</td><td><span class="tag tag-running">RUNNING</span></td><td><code>/etc/supervisor/conf.d/jaika.conf</code></td></tr>
<tr><td>Dashboard</td><td>5000</td><td><span class="tag tag-running">RUNNING</span></td><td>Boot service script</td></tr>
<tr><td>SSH</td><td>22</td><td><span class="tag tag-running">RUNNING</span></td><td>Boot service script</td></tr>
<tr><td>Tailscale</td><td>-</td><td><span class="tag tag-running">RUNNING</span></td><td>Boot service script</td></tr>
<tr><td>Ollama</td><td>11434</td><td><span class="tag tag-stopped">REMOVED</span></td><td>Deleted</td></tr>
<tr><td>Ollama Chat</td><td>5000</td><td><span class="tag tag-stopped">REMOVED</span></td><td>Deleted</td></tr>
</table>
<h3>Adding a New Service</h3>
<pre><code># Create supervisor config
printf "[program:myservice]
command=/path/to/command
directory=/path/to/workdir
autostart=true
autorestart=true
stdout_logfile=/var/log/server/myservice-out.log
stderr_logfile=/var/log/server/myservice-err.log
" > /etc/supervisor/conf.d/myservice.conf
# Activate
supervisorctl reread && supervisorctl update</code></pre>
<h2>Tailscale Funnel / Serve</h2>
<h3>Current Config</h3>
<pre><code># Check status
tailscale serve status
# Expose a local port publicly via Funnel
tailscale funnel --bg --https 443 http://localhost:5244
# Expose on a different external port
tailscale funnel --bg --https 10000 http://localhost:5000
# Remove a funnel
tailscale funnel --https=443 off
# Reset all
tailscale funnel reset
tailscale serve reset</code></pre>
<h2>Jaika v2 Specifics</h2>
<div class="card">
<h3>File Locations</h3>
<table>
<tr><th>What</th><th>Path</th></tr>
<tr><td>App code</td><td><code>/opt/jaika-v2/</code></td></tr>
<tr><td>Python venv</td><td><code>/opt/jaika-v2/.venv/</code></td></tr>
<tr><td>.env config</td><td><code>/opt/jaika-v2/.env</code></td></tr>
<tr><td>User data</td><td><code>/opt/jaika-v2/data/users/</code></td></tr>
<tr><td>Skills</td><td><code>/opt/jaika-v2/data/skills/</code></td></tr>
<tr><td>Supervisor config</td><td><code>/etc/supervisor/conf.d/jaika.conf</code></td></tr>
<tr><td>Stdout log</td><td><code>/var/log/server/jaika-out.log</code></td></tr>
<tr><td>Stderr log</td><td><code>/var/log/server/jaika-err.log</code></td></tr>
</table>
</div>
<h3>Update Jaika Code</h3>
<pre><code># From your Mac:
adb push /Users/jai.goyal/Documents/gemini-ui-dist/v2/jaika-v2/ /sdcard/jaika-v2/
adb shell "su 0 cp -r /sdcard/jaika-v2/* /data/local/linux/rootfs/opt/jaika-v2/"
# Then restart:
adb shell "su 0 chroot /data/local/linux/rootfs /bin/bash -c 'export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin; supervisorctl restart jaika'"</code></pre>
<h3>Update .env</h3>
<pre><code># Via ADB (escape quotes carefully):
adb shell "su 0 chroot /data/local/linux/rootfs /bin/bash -c 'export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin; printf \"KEY=VALUE\n\" > /opt/jaika-v2/.env'"
# Then restart
supervisorctl restart jaika</code></pre>
<h3>Install New Python Packages</h3>
<pre><code>adb shell "su 0 chroot /data/local/linux/rootfs /bin/bash -c 'export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin; export HOME=/root; unset ANDROID_DATA ANDROID_ROOT ANDROID_BOOTLOGO ANDROID_ASSETS; /opt/jaika-v2/.venv/bin/pip install PACKAGE_NAME'"</code></pre>
<h2>System Monitoring</h2>
<pre><code># Memory
free -m
# Disk
df -h /
# Top processes
ps aux --sort=-%mem | head -15
# Temperature (Android)
cat /sys/class/thermal/thermal_zone*/temp</code></pre>
<h2>Boot Process</h2>
<p>On device boot:</p>
<ol>
<li><code>/system/etc/init/android-server.rc</code> triggers boot wrapper</li>
<li><code>boot-auto.sh</code> mounts chroot filesystems, enables swap</li>
<li>Inside chroot: starts SSH, cron, Tailscale, Supervisor</li>
<li>Supervisor auto-starts all configured services (including Jaika)</li>
</ol>
<h2>Troubleshooting</h2>
<div class="warn">
<strong>pip broken?</strong> Always unset Android env vars: <code>unset ANDROID_DATA ANDROID_ROOT ANDROID_BOOTLOGO ANDROID_ASSETS</code>
</div>
<div class="warn">
<strong>SSH not connecting?</strong> Tailscale uses userspace networking — SSH over Tailscale IP may not work. Use ADB instead.
</div>
<div class="warn">
<strong>Service not starting?</strong> Check logs: <code>tail -50 /var/log/server/jaika-err.log</code>
</div>
<div class="warn">
<strong>PATH issues?</strong> Always export: <code>export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin</code>
</div>
</body>
</html>