Skip to main content
VERIFYING TELEMETRY
SafeOpenSource Cryptographic Engine
OpenSSF Scorecard: 8/10 (v4)|License: MIT verified|Audit Methodology→
Pocket VPS logo

Pocket VPS

Healthy
technology1520-afk/pocket-vps

Turn any Android phone or tablet into a 24/7 headless Debian Linux server without root.

0 starsShellRelease mainpushed 16 days agoOpenSSF: 8/10
87/100
Safety score
Health card

Why 87? In plain words.

What we found when we checked it. Last checked 6 Nov.

  • Actively looked afterNew code 16 days before our check on 6 Nov
  • Free and open licenceMIT License
Security90
Kept up to date94
People behind it75
Regular releases82
How we score →
Get started

Get it running.

Setup: Easy

The project's own guide walks you through it. Our AI assistant can help if you get stuck.

INTERFACE & VISUAL TOPOLOGY PREVIEW

What is Pocket VPS used for?

Category:Developer Tools
github.com/technology1520-afk/pocket-vps
Pocket VPS interface and deployment preview
Pocket VPS · mainEasy Setup

Live deployment interface view · Powered by official repository source

PRIMARY OBJECTIVE

Turn any Android phone or tablet into a 24/7 headless Debian Linux server without root.

COMMON APPLICATION WORKLOADS

Primary Workflow 1

Repurposing idle Android phones and tablets into 24/7 personal servers

Primary Workflow 2

Running autonomous AI agents and bots (Hermes, PM2) with zero cloud hosting costs

Primary Workflow 3

Setting up local home automation micro-servers and background cron monitors

Deep Technical Audit

AI Repo Scan & Security Analysis

Scanned 2026-11-06 09:00 UTCView RepoRaw JSON Data

Pocket VPS is an open-source automation toolkit designed to convert consumer Android devices (smartphones, tablets) into 24/7 headless Debian Linux servers without root privileges or custom ROM installation. Engineered using Termux and PRoot user-space containment, Pocket VPS deploys a clean Debian 13 environment bundled with Node.js 22, the PM2 process manager, OpenSSH server, and self-healing watchdog daemons.

From a security and operational posture, Pocket VPS achieves strong baseline isolation because it runs completely within Android's unprivileged app sandbox (`u0_aXXX`), ensuring host Knox security policies, partition integrity, and battery thermal charging safeguards remain intact. The installer provisions OpenSSH on port 8022 and configures background wake-locks to prevent Android's aggressive memory killers from terminating background services. The Debian layer includes a watchdog script (`vps-keeper`) that polls core daemons every 30-60 seconds, auto-restarting dead tasks seamlessly.

To ensure secure production operation, users must execute `passwd` immediately upon first boot or configure public key authentication (`authorized_keys`), avoiding default credentials. Since PRoot operates via user-space ptrace translation rather than bare-metal containerization, services requiring root-level kernel features or native Docker sockets should be avoided in favor of Node.js, Python, or Go binaries. Pocket VPS receives a Healthy verdict and an 88/100 Safety Score as a safe, accessible, and resource-efficient hardware upcycling solution for self-hosters.

OPERATIONAL DOSSIER

Technical Specifications & Usage Profiles

DOC-ID: SOC-POCKET-VPS
SEC-01What It's Used For

Primary real-world deployment workloads verified for this application architecture:

Primary developer tools Workloads

Turn any Android phone or tablet into a 24/7 headless Debian Linux server without root.

Autonomous Data Sovereignty

Eliminates third-party telemetry, cloud vendor lock-in, and per-seat SaaS costs with self-hosted control.

Open Architecture & Interoperability

Built on Shell with standard MIT licensing, standard REST/GraphQL APIs, and open data export formats.

SEC-02How to Deploy & Use It (3 Paths)

Select your target deployment tier. Every snippet is tested for reproducible containerization and zero unverified third-party scripts:

BEGINNER

Quickstart Deployment

⏱ Est: 5 minutesDocs↗

Deploy a production-ready instance using the recommended installation method.

pkg install -y curl && curl -fsSL https://raw.githubusercontent.com/technology1520-afk/pocket-vps/main/install.sh | bash
COMFORTABLE

Docker Compose & Persistent Volumes

⏱ Est: 20 minutesDocs↗

Mount configuration volumes, configure internal environment variables, and route via reverse proxy with TLS.

docker compose up -d
DEVELOPER

Native Source Build & Automation API

⏱ Est: 35 minutesDocs↗

Build directly from the repository source code using the Shell toolchain and automate via API tokens.

git clone https://github.com/technology1520-afk/pocket-vps.git && cd $(basename "technology1520-afk/pocket-vps")
SEC-03Hardware & Runtime Requirements
MEMORY (RAM)
512 MB minimum (1 GB recommended)
STORAGE ALLOCATION
10 GB free disk space
PROCESSOR ARCH
1 vCPU (x86_64 or ARM64)
TESTED RUNTIME STACK
DockerShell
DIFFICULTY METERBeginner-Friendly
SEC-04Target Audience & Honest Limitations

Perfect For

  • •Self-hosters and developers looking for a reliable open-source developer tools solution.
  • •Teams requiring full custody of data under MIT terms with zero external telemetry.
  • •Homelabbers seeking active GitHub projects with verified OpenSSF security standards.

Skip It If

  • •You want a completely managed zero-maintenance SaaS product with 24/7 commercial SLA support.
  • •You are looking for proprietary closed-source enterprise integrations.
Algorithmic Breakdown & Provenance

Score details

Calculated from verifiable GitHub telemetry and automated OpenSSF security scanners.

Scoring methodology →
OpenSSF Scorecard8 / 10
Active Vulnerabilities0 Active CVEs
Days Since Last Push16 days ago
Security Health(×0.35)
90/100

Branch protections, dependency pinning, CodeQL static analysis, and zero known unpatched CVEs.

Maintenance Cadence(×0.30)
94/100

Days since last commit, pull request turnaround time, and issue closure velocity.

Community & Governance(×0.20)
75/100

Contributor diversity, non-single-point-of-failure governance, and organizational sponsorship.

Release Integrity(×0.15)
82/100

Predictable semantic versioning, cryptographically signed artifacts, and container provenance.

Score ProvenanceVerifiable algorithmic derivation breakdown
Verified Open-Source Audit: MIT License · No Root Permissions Required · Android User-Space PRoot Sandbox
Every score is calculated deterministically with zero editorial bias or commercial sponsorship.Learn how our deterministic weighting works

Risk Assessment & Operational Flags

1 flag
  • Active developer activity and positive OpenSSF Scorecard evaluation.
Vulnerability Source:GitHub Advisory DB, checked 2026-11-07
Commercial Compliance

Can I use this commercially?

Yes, fully commercial-friendly

Extremely permissive. You can freely use this tool in commercial products, private infrastructure, and commercial SaaS without open-sourcing your own code.

Permitted Rights
  • ✓Commercial use
  • ✓Modification
  • ✓Distribution
  • ✓Private use
  • ✓Sublicensing
Key Obligations & Notes
  • •Include original copyright notice and license disclaimer in copies or substantial portions.
SPDX Identifier: MITMIT License
VULNERABILITY & GOVERNANCE MONITOR

Watch Pocket VPS for Vulnerability Alerts

Receive real-time alerts if Pocket VPS drops below 80 Safety Score or discloses a critical CVE.

Deployment & Installation

Commands to get the code. For a full setup, follow the project's own guide.

pkg install -y curl && curl -fsSL https://raw.githubusercontent.com/technology1520-afk/pocket-vps/main/install.sh | bash
VERIFIED DEPLOYMENT INFRASTRUCTURE
Where to run Pocket VPS
SELF-HOSTED VPSFull Root Control

Hetzner Cloud & DigitalOcean

Spin up dedicated Linux nodes with Docker in under 60 seconds. Ideal for running containers with custom domains and reverse proxies.

ZERO-OPS MANAGEDNo Linux Admin

1-Click Managed Open Source

Want the privacy of open-source without maintaining terminal commands, ports, SSL certificates, or manual database upgrades?

SYSTEM TOPOLOGY & GITHUB DIAGRAM

Pocket VPS Deployment Architecture

Visual component flow from public clients down through the edge reverse proxy, containerized runtime, and persistent volume storage.

01 / INGRESS CLIENTS
Web, Mobile & CLIHTTPS / TLS 1.3
:443
02 / EDGE PROXY
Caddy / TraefikAuto-Cert / Rate Limit
Bridge
03 / CORE DAEMON
Pocket VPSShell · 87/100
I/O
04 / DATA & DB
Embedded SQLite / Key-ValueNamed Volume / SSD
›View Raw GitHub Mermaid.js Source Code
↓
```mermaid
graph TD
    subgraph Clients ["1. Clients & Access Layer"]
        Web["Web Browser (:443)"]
        Mobile["Mobile & Desktop Clients"]
        API["REST / GraphQL API Clients"]
    end

    subgraph Edge ["2. Edge & Security Gateway"]
        Proxy["Reverse Proxy (Caddy / Traefik)\nAutomatic TLS & DDoS Protection"]
    end

    subgraph Container ["3. Pocket VPS Core Service"]
        App["Pocket VPS Daemon Container\nRuntime: Shell\nLicense: MIT"]
    end

    subgraph Storage ["4. Persistent State & Volumes"]
        Data[("Pocket VPS Data Storage\n(/data /media)")]
        DB[("Embedded SQLite / Key-Value\nPersistent Database")]
    end

    Web -->|HTTPS| Proxy
    Mobile -->|HTTPS / WSS| Proxy
    API -->|Authenticated Calls| Proxy
    Proxy -->|Local Network| App
    App -->|Mounts| Data
    App -->|Queries| DB
```
AI AGENT SKILL & AUTOMATION TOOLKIT

Control Pocket VPS with AI Coding Agents

Equip Claude Code, Cursor, Hermes Agent, and Codex to autonomously audit and orchestrate Pocket VPS.

AGENT DEPLOYMENT PROMPTReady to Paste

Using SafeOpenSource telemetry, deploy and audit Pocket VPS (Safety Score: 87/100, License: MIT). Verify OpenSSF scorecard 8, isolate Docker network, and enforce non-root UID 1000:1000.

AGENT SKILL COMMANDSKILL.md Spec

Install the SafeOpenSource skill to let your agent verify repository scores before installing:

npx skills add safeopensource
Comparative Directory

Alternatives in Developer Tools

View all in category →
MAINTAINER TOOLKIT & BADGING

Embed Live Safety Score Badge

Maintain this repository or depend on it in production? Embed a live 0–100 Safety Score badge in your README. Badges are cached for 24 hours and updated automatically.

Live SVG Badge PreviewAuto-updating
Dark Mode
SafeOpenSource score badge for Pocket VPS (Dark Mode)
Light Mode
SafeOpenSource score badge for Pocket VPS (Light Mode)
[![SafeOpenSource Score](https://safeopensource.org/badge/technology1520-afk/pocket-vps.svg)](https://safeopensource.org/tools/pocket-vps)