photonglass

A modern, distributed looking glass application that provides network insight for network operators.

See it live

https://photonglass.dev

Features

Multi Device Support: Connect to multiple devices from one single interface.
Easy Deployment: Extremely easy to deploy and scale with multiple devices.

Setup (Docker)

Clone repository
- git clone https://github.com/AliMickey/photonglass.git
Create an instance folder to store your config and logos/favicon
- cd photonglass
- mkdir instance
- mkdir instance/images
Create config files and upload logos/favicon (follow config template below)
Create docker-compose.yml (follow template below)
Build and deploy the container (inital build may take a minute)
- docker compose up -d --build
View the app at http://IP_ADDRESS:5000, recommend using a reverse proxy (traefik) for production use.

Configuration

docker-compose.yml

services:
  photonglass:
    container_name: photonglass
    restart: unless-stopped
    build: .
    ports:
      - 5000:5000
    volumes:
      - ./instance:/instance
#      - ./instance/images:/app/static/images # Commented out by default to use default logos

instance/config.yaml

header:
  title: "photonglass"
  logo_href: "#"

footer:
  text: "photonglass"
  peeringdb_href: "https://www.peeringdb.com"
  github_href: "https://github.com/alimickey"

instance/commands.yaml

- id: "ping"
  display_name: "Ping"
  format: "ping -{ip_version} -c 4 {target}"
  description: "Test network connectivity"
  field:
    type: "text"
    placeholder: "Enter IP address or hostname"

- id: "traceroute"
  display_name: "Traceroute"
  format: "traceroute -{ip_version} {target}"
  description: "Trace network path to destination"
  field:
    type: "text"
    placeholder: "Enter IP address or hostname"

- id: "mtr"
  display_name: "MTR"
  format: "mtr -{ip_version} -r {target}"
  description: "Trace network path with stats"
  field:
    type: "text"
    placeholder: "Enter IP address or hostname"

instance/devices.yaml

- id: "unique-sydney"
  display_name: "Sydney"
  subtext: "Equinix SY3"
  country_code: "AU"
  type: "linux"
  host: "IP_ADDRESS"
  port: PORT
  username: "USERNAME"
  password: "PASSWORD"
  commands:
    - ping
    - traceroute
    - mtr

Attribution

This project was inspired by hyperglass after having difficulty deploying it. This project is not meant as a 1:1 replacement with hyperglass and as such is kept simple by design. At time of release only linux servers were tested as a target device, the same device library as hyperglass is used (netmiko) so compatibility with more devices should not be an issue, just be aware it is untested.

2.9 KiB Raw Blame History