https://github.com/sidpatchy/docker-meshview
Docker container for Meshview
https://github.com/sidpatchy/docker-meshview
docker docker-compose meshtastic meshview mqtt
Last synced: about 1 month ago
JSON representation
Docker container for Meshview
- Host: GitHub
- URL: https://github.com/sidpatchy/docker-meshview
- Owner: Sidpatchy
- License: gpl-3.0
- Created: 2025-07-14T17:53:49.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-17T19:34:30.000Z (11 months ago)
- Last Synced: 2026-04-24T16:54:16.347Z (about 2 months ago)
- Topics: docker, docker-compose, meshtastic, meshview, mqtt
- Language: Shell
- Homepage:
- Size: 26.4 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# docker-meshview
Docker container for [Meshview](https://github.com/pablorevilla-meshtastic/meshview) - a real-time monitoring and diagnostic tool for Meshtastic mesh networks.
## Quick Start
Ensure you have Docker installed using the officially supported method.
https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository
```bash
# Clone the repo and enter its directory
$ git clone https://github.com/Sidpatchy/docker-meshview
$ cd docker-meshview
# Build the container
$ docker compose build --no-cache
# Initialize the config and database file
$ touch packets.db
$ chmod 666 packets.db
# Check your UID and GID
$ id
uid=1000(testuser) gid=1000(testuser) # You should get something like this
# Edit the docker-compose file to use your UID and GID
$ nano docker-compose.yml
# Change the PUID to your UID and the PGID to your GID
- PUID=1000
- PGID=1000
# Download the config from upstream and modify to your liking
$ curl -o config.ini https://raw.githubusercontent.com/pablorevilla-meshtastic/meshview/refs/heads/master/sample.config.ini
$ nano config.ini
# Start the contaner
$ docker compose up -d
```
## Updating
```bash
# Bring down the stack
docker compose down
# Rebuild the containers
docker compose build --no-cache
# Bring the stack back up
docker compose up -d
```
## Parameters
### Ports
Ports are separated by a colon and indicate `:`. For example, `9872:8081` would expose port 8081 from _inside_ the container to be accessible from _outside_ the container through port 9872.
#### Meshview container
| Port | Function |
|-----------|----------------|
| 8081:8081 | HTTP(s) web UI |
#### Database Cleanup Sidecar
N/A
### Environment Variables
#### Meshview Container
| Parameter | Function |
|---------------|-----------------------------------------------------------------------------------------------|
| CONFIG_FILE | Path to the config.ini file within the container (Optional) |
| DATABASE_FILE | Path to the packets.db file within the container. (Optional) |
| PUID | Process User ID - Avoids causing issues with permissions between the host and the container. |
| PGID | Process Group ID - Avoids causing issues with permissions between the host and the container. |
#### Database Cleanup Sidecar
| Parameter | Function |
|----------------|-----------------------------------------------------------------------------------------------|
| DATABASE_FILE | Path to the packets.db file within the container. (Optional) |
| RETENTION_DAYS | How many days to retain data (Optional) (Default: 14 days) |