stackedge

Stackedge

Decentralized App Hosting on Android using Termux + Tor

Stackedge is a Termux-friendly app hosting system that allows you to run any web app (Node.js, PHP, Go, etc.) on your Android device. Inspired by the desire to build something decentralized, privacy-focused, and open-source, Stackedge integrates Tor onion services to make your apps accessible anywhere safely.

Your apps start immediately, Tor bootstraps in the background, and you can manage them via a simple CLI (start, stop, restart, list, resurrect).

Features

• Run any app (Node.js, PHP, Go, Python…) from the folder you are in.

• Tor integration for onion services.

• Apps start immediately; Tor bootstraps in the background.

• Resilient to Wi-Fi drops or Termux restarts.

CLI commands similar to pm2:

• stackedge start --

• stackedge stop

• stackedge restart

• stackedge list

• stackedge resurrect

• Fallback command shows status and help.

Open-source and focused on privacy & decentralization.

Table of Contents

Requirements

1.Installation

2.Setup

Usage

1.Termux Auto-Resurrect

Project Philosophy

Support

Requirements

Android device

Termux installed

Installed Termux packages:

pkg update && pkg upgrade -y
pkg install nodejs git tor -y

Optional for PHP apps:

pkg install php -y

Optional for Go apps:

pkg install golang -y

Optional for Python apps:

pkg install python -y

Installation

Clone the Stackedge repository:

cd $HOME
git clone https://github.com/Frost-bit-star/stackedge.git
cd stackedge

Install globally via npm:

npm install -g .

Make sure the CLI is executable:

chmod +x $HOME/.npm-global/bin/stackedge

Verify installation:

stackedge

You should see a status summary and available commands.

Setup

Stackedge uses the following directory structure in Termux:

$HOME/.stackedge/
 ├── apps.json             # Stores all app info
 ├── tor/
 │   ├── torrc             # Tor config
 │   └── services/         # Onion services storage
 └── logs/                 # App logs

Stackedge automatically creates these directories on first run.

Usage

Start an app

Navigate to the app folder and run:

cd ~/my-react-app
stackedge start blog -- npm start

• blog is the app name.

• Everything after -- is the command to start your app.

Tor starts in the background; your app starts immediately.

The onion address will appear once Tor is fully bootstrapped.

Stop an app

• stackedge stop blog

Restart an app

• stackedge restart blog

List all apps

• stackedge list

Shows:

• App name

• App state (running/stopped)

• Port

• Tor state (pending/online)

• Onion address

• Resurrect all apps

Use this to restore apps after Termux restart or Wi-Fi loss:

• stackedge resurrect

• Termux Auto-Resurrect

To automatically restore apps when Termux opens:

echo 'if command -v stackedge >/dev/null; then stackedge resurrect >/dev/null 2>&1 & fi' >> ~/.bashrc

• Apps will start immediately.

• Tor will bootstrap in the background.

• No manual intervention needed.

• Project Philosophy

Stackedge is:

Open-source: Learn, modify, and contribute.

• Privacy-focused: Tor integration keeps your apps secure and accessible anonymously.

• Decentralized hosting on Android: Your device becomes your own server.

• Inspired by a love for Termux and building something great, this project is for developers, hackers, and privacy enthusiasts.

Check out my other projects and tutorials: here

☕ Support This Project

If you value open-source and anonymity, support me so I can keep building decentralized hosting tools on Android:

License

MIT License – Open source for everyone.