https://github.com/elysiummachines/homelab-map

Interactive homelab network map built with React and Vite, visualizes infrastructure, devices, and topology. Desktop and mobile friendly.
https://github.com/elysiummachines/homelab-map

docker-compose homelab javascript network-map nginx nodejs proxmox-cluster react self-hosted vite vscode

Last synced: 2 months ago
JSON representation

Interactive homelab network map built with React and Vite, visualizes infrastructure, devices, and topology. Desktop and mobile friendly.

• Host: GitHub
• URL: https://github.com/elysiummachines/homelab-map
• Owner: elysiummachines
• License: mit
• Created: 2026-03-15T02:58:21.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2026-03-19T04:44:58.000Z (3 months ago)
• Last Synced: 2026-03-27T15:38:18.793Z (3 months ago)
• Topics: docker-compose, homelab, javascript, network-map, nginx, nodejs, proxmox-cluster, react, self-hosted, vite, vscode
• Language: JavaScript
• Homepage: https://homelab-map.elysiummachines.com/
• Size: 5.84 MB
• Stars: 15
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          


# 🖥️ Homelab Map

**An interactive visual map of my homelab infrastructure, devices, and network topology.**

[![Release](https://img.shields.io/github/v/release/elysiummachines/homelab-map?style=flat-square&color=blue)](https://github.com/elysiummachines/homelab-map/releases)

[![Downloads](https://img.shields.io/github/downloads/elysiummachines/homelab-map/total?style=flat-square&color=ff0000)](https://github.com/elysiummachines/homelab-map/releases)

[![Node](https://img.shields.io/badge/Node-v18+-green?style=flat-square)](https://nodejs.org/)

[![Vite](https://img.shields.io/badge/Vite-React-cyan?style=flat-square)](https://vitejs.dev/)

[![License](https://img.shields.io/badge/License-MIT-grey.svg?style=flat-square)](LICENSE)

[![Stars](https://img.shields.io/github/stars/elysiummachines/homelab-map?style=social)](https://github.com/elysiummachines/homelab-map/stargazers)

[Features](#features) • [Getting Started](#getting-started) • [Changelog](CHANGELOG.md)



![Homelab Map demo](demo.gif)

## Overview

Homelab Map is a React + Vite web application that provides an interactive visual representation of my homelab - including devices, services, and network topology.

## Features

- Interactive node-based network map

- Visual representation of devices and services

- Animated particle network background

- Clean, modern dark UI

## Getting Started

### Prerequisites

- [Node.js](https://nodejs.org/) v18 or higher

- npm

### Installation

```bash

git clone https://github.com/elysiummachines/homelab-map.git

cd homelab-map

npm install

```

### Development

```bash

npm run dev

```

### Production Build

```bash

npm run build

```

Outputs to the `dist/` folder.

## Project Structure

```

homelab-map/

├── public/          # Static files

├── src/             # React source

│   ├── assets/      # Icons and images

│   ├── App.jsx      # Main UI component

│   └── App.css      # Styles

├── index.html

└── vite.config.js

```

## Changelog

See [CHANGELOG.md](CHANGELOG.md) for version history.

## License

MIT