gsmnode

gsmnode is a single Docker container that turns a spare Android phone into a programmable SMS and call gateway, letting self-hosters send and receive messages…

  • Communication
  • Home Automation
  • Network Services
  • Productivity
  • Tools & Utilities
gsmnode is a single Docker container that turns a spare Android phone into a programmable SMS and call gateway, letting self-hosters send and receive messages through a web app or the REST API. It bundles PocketBase, the API server, and the web app together, with idempotent first-boot setup so restarts are safe.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

51/100 Fair

Maintained
82last commit 28 days ago
Popular
144 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 26 days ago

GitHub stars
4
Open issues
0
Last commit
2026-10-24
Latest release
v1.0.0
License
Apache-2.0
Activity
steady

Checked 8 days ago - source: GitHub (gsmnode/gsmnode)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • First boot and access On first boot, PocketBase creates its superuser from the PB_ADMIN_* environment variables and the API server reconciles the database schema; if GSMNODE_SUPERADMIN_* is set, it also creates the first app login. All steps are idempotent, so restarts are safe. Local ports: PocketBase admin on 8070 (under /_/), API server and panel on 8080, web app on 8090. Only the GSMNODE_SUPERADMIN login can open t source

Fetched 39 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How are the initial admin accounts created on first boot?

PocketBase upserts its superuser from PB_ADMIN_* variables, and the API server creates the first app login from GSMNODE_SUPERADMIN_* variables if they are set. These steps are idempotent, so restarts are safe.

Which ports do the gsmnode components use?

Use port 8070 for the PocketBase admin interface, port 8080 for the API server and panel, and port 8090 for the web app.

What Android components are separate from the all-in-one container?

The Android Phone Agent and Android Phone App are separate release components for the Android phone side.

Can gsmnode be used with Home Assistant?

An optional Home Assistant plugin can be installed through HACS from gsmnode/gsmnode -ha, or the custom_components/gsmnode folder can be copied into Home Assistant.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads