Moltis — Your Pocket AI Workstation

Turn any Android phone into a private AI server, Git forge, and web host.
Zero emulation. Zero cloud dependency. True Bionic VPS orchestration.

---

What is Moltis?

Moltis transforms a spare Android phone into a true private VPS running on the device's native hardware. All binaries are compiled natively against Bionic. Services are orchestrated via termux-services (runit) just like systemd on a real server.

Service	Port	What it does
Moltis AI	46697	Multi-provider AI gateway with 340+ models, web UI, MCP integrations, and robust SQLite memory.
Forgejo	3001	A full Git forge — repositories, issues, PRs — mapped instantly on Android's secure Ext4.
Caddy	3002	Automated web hosting routing docs & dashboards.
VS Code Patcher	N/A	Self-healing watchdog that auto-patches VS Code Remote-SSH binaries for Bionic.

---

Overcoming Android's VPS Constraints (Why Moltis works)

To make a phone act like a server, Moltis automatically accounts for core Android "quirks":

1. The Phantom Process Killer: Android 12+ randomly kills child background apps to save battery. (See Setup section regarding the ADB command to fix this).
2. The Hardcoded Path Trap (/bin/bash missing): We seamlessly intercept hardcoded unix paths using termux-exec (LD_PRELOAD), allowing node-pty, python bots, and random bash scripts to work as if they are running on Ubuntu.
3. No systemd / Init bindings: Bootstraps termux-services (runit module) so if Forgejo or Moltis crashes, they automatically auto-restart.
4. OOM Killer: Services run with elevated nice/ionice priority, and termux-wake-lock prevents CPU sleep.
5. VS Code Impedance Mismatch: The self-healing patcher intercepts glibc Node.js binaries and hot-swaps them with native Bionic node, fixing the cxx_abstract / File Not Found linker errors.

---

Install / Setup

Get Termux (via F-Droid, NOT Google Play). Then paste:

curl -fsSL https://raw.githubusercontent.com/Muxd21/moltis-termux/FULL/install.sh | bash

⚠️ Critical Step for True VPS Stability

You must disable the Phantom Process Killer holding your server back, or Android will mysteriously kill your AI gateway after a few hours:

Plug your phone into a PC (or use Wireless Debugging tools) and run:

adb shell "settings put global phantom_process_handling false"

(Also set Termux AND Tailscale Battery usage to 'Unrestricted' in Android Apps settings).

---

Managing Your Services

Because Moltis uses termux-services, you don't rely on brittle background commands. You use the service manager (sv).

Boot the Suite

moltis-up        # Starts moltis, caddy, forgejo, vscode-patcher via sv + wakelock
moltis-dev       # Pro mode (adds SSLH stealth multiplexer on :4433)

Manual Service Control

sv up caddy      # Start Caddy web server
sv down forgejo  # Stop Git Forge
sv status moltis # Check if the AI gateway is running
cat $PREFIX/var/log/moltis/current  # Read your service logs

Health Check

moltis-status    # Shows service status, network IPs, and VS Code patch status

---

The Antigravity VS Code Fix

VS Code Remote-SSH fails on Android because it downloads a generic Linux Node.js binary compiled for glibc. Moltis includes a Self-Healing Patcher that:

1. Intercepts glibc Node.js binaries in ~/.vscode-server/bin/
2. Hot-swaps them with a Bionic wrapper that execs into Termux's native node
3. Grafts native pty.node C++ bindings compiled against Bionic
4. Watches for new VS Code updates via inotifywait filesystem watchdog

# Manual patching
moltis-fix-vscode           # Patch all VS Code servers
moltis-fix-vscode --force   # Force re-patch everything
moltis-fix-vscode --watch   # Start filesystem watchdog (auto-patches new updates)

The watchdog also runs as a runit service (sv status vscode-patcher), so new VS Code updates are patched automatically in the background.

---

SSH Configuration

On the Phone (deployed automatically by installer)

The installer deploys a hardened sshd_config at $PREFIX/etc/ssh/sshd_config with:

• Port 8022 — non-standard port for Android
• TCPKeepAlive + ClientAliveInterval — prevents Android from reaping the SSH process
• AllowTcpForwarding + GatewayPorts — enables VS Code port tunneling
• Compression — optimized for mobile data

On Your Laptop (~/.ssh/config)

Add this entry for a frictionless "always-on" connection:

Host moltis
    HostName 100.x.x.x  # Your Tailscale IP
    User termux
    Port 8022
    # Antigravity connection stability
    ServerAliveInterval 15
    ServerAliveCountMax 3
    # Reuse connections for instant reconnect
    ControlMaster auto
    ControlPath ~/.ssh/moltis-%r@%h:%p
    ControlPersist 5m

---

The Pro Dev Toolkit

Along with core services, install.sh provisions a native pocket toolkit designed to emulate root-level workflows inside the unprivileged Bionic sandbox:

• mosh: Persistent SSH connections surviving network handoffs between LTE and home Wifi.
• socat / entr: Advanced port forwarding and directory live-watching.
• sslh (Dev Mode): Automatically detects if an incoming connection is SSH or HTTP on a single port (like 4433) bypassing corporate firewalls.
• tmux: Terminal multiplexer for persistent sessions.

---

Command Reference

Command	Description
moltis-up	Start all services with wakelock + process priority elevation
moltis-stop	Stop all services + release wakelock
moltis-dev	Pro Mode (all services + SSLH stealth mux on :4433)
moltis-status	Health check: services, network, VS Code patch status
moltis-fix-vscode	Patch VS Code servers for Bionic (--force, --watch)
moltis-update	Self-update installer + re-patch VS Code
moltis-bot-setup	Add any script as a supervised runit service
sv status <name>	Check individual service (moltis, forgejo, caddy, sslh, vscode-patcher)

Networking via Tailscale

Standard public binding fails on mobile networks due to CGNAT. Connect the Termux instance to Tailscale natively:

1. pkg install tailscale
2. tailscaled 2>&1 & tailscale up
3. Access your phone's stable 100.x.x.x IP globally.

---

License

MIT - See the LICENSE file for details.