# 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 through a web app or the REST API. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2440/gsmnode

## Description

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.

## Health score

51/100 (Fair), based on 3 of 4 factors.
- Maintained: 82 (last commit 28 days ago)
- Popular: 14 (4 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/tajniak81/gsmnode-aio
- GitHub: https://github.com/gsmnode/gsmnode
- Unraid: https://ca.unraid.net/apps/gsmnode-1muffoc1hclvi8?q=gsmnode

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/2440/gsmnode), the self-hosted and open-source app directory.
