scanopy-server

scanopy-server

Official

Docker app from Fallen94's Repository

Overview

Automatically discover and visually document network topology. Requirements: The server requires a postgres database. The SCANOPY_DATABASE_URL needs to match your postgres Example: postgresql://username:password@hostname:port/database postgresql://scanopy:password123@db:5432/scanopy

Scanopy

Scanopy Logo

Network documentation, without the drawing.

Scanopy replaces manual network diagrams with a continuously maintained model of what's actually running. A single daemon scans on a schedule and produces four views from each scan: L2 (physical), L3 (logical), workloads, and applications. Unlike diagrams drawn in draw.io that go stale the week they're saved, or IaC state that misses drift and resources provisioned outside the pipeline, Scanopy reflects the current state of your infrastructure. Export as SVG, Mermaid, or Confluence; embed live maps; or feed the model into your existing source of truth.

Docker Pulls Github Stars
GitHub release License
Daemon image size Server image size
Daemon Server UI
Discord Translations

πŸ’‘ Prefer not to self-host? Get a free trial of Scanopy Cloud

L2 view

L2 (Physical)
Every switch, every port, every link.

L3 view

L3 (Logical)
Subnets and how hosts connect across them.

Workloads view

Workloads
Bare metal to hypervisors to containers.

Applications view

Applications
Services and their dependencies, grouped by application.

✨ Features

  • Automatic discovery: Maps hosts and services by scanning the network. One scanner, no per-device agents.
  • 230+ service definitions: Auto-detects databases, web servers, containers, network infrastructure, and enterprise applications.
  • Four views from one scan: L2 (physical), L3 (logical), workloads, and application dependencies.
  • Distributed scanning: Deploy daemons across segments to map multi-site and multi-VLAN topologies.
  • Docker & SNMP integration: Native discovery for containerized services and network hardware.
  • Scheduled rescans: Documentation stays current as infrastructure changes.
  • Multi-user + RBAC: Organization management, role-based access, and shareable live views for teammates or external stakeholders.

🎯 Perfect For

  • Platform & DevOps teams: Trace service dependencies without APM. Map containers, VMs, and hardware in one model.
  • Network engineers: Multi-VLAN, multi-site topology diagrams derived from SNMP, LLDP, and ARP. No manual drawing.
  • IT operations: Keep inventory, topology, and dependencies current across teams and sites.
  • MSPs: Per-client documentation with shareable live views.
  • Home labs: Document your infrastructure without opening draw.io.

πŸ“‹ Licensing

Self-hosted (AGPL-3.0): Free for all use. Requires source disclosure for network services and copyleft compliance.
Self-hosted (Commercial license): For those who cannot comply with AGPL-3.0 terms. Contact licensing@scanopy.net
Hosted Solution: Scanopy Cloud subscription for zero infrastructure management

πŸš€ Quick Start for Self Hosting

Docker Compose

curl -O https://raw.githubusercontent.com/scanopy/scanopy/refs/heads/main/docker-compose.yml
docker compose up -d

Proxmox

Use this helper script to create a Scanopy LXC.

Unraid

Available as an Unraid community app.

πŸ’‘ Prefer not to self-host? Get a free trial of Scanopy Cloud


Access the UI at http://<your-server-ip>:60072, create your account, and wait for the first discovery to complete.

For detailed setup options and configuration, see the Installation Guide.

πŸ“š Documentation + API

scanopy.net/docs

πŸš€ Demo

demo.scanopy.net. Hosted demo app with a sample dataset. Try the full UI without installing anything.

🀝 Contributing

We welcome contributions! See our contributing guide for details.

Great first contributions:

πŸ’¬ Community & Support


Translations powered by Weblate

Built with ❀️ in NYC

Install scanopy-server on Unraid in a few clicks.

Find scanopy-server in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for scanopy-server Review the template variables and paths Click Install

Related apps

Details

Repository
ghcr.io/scanopy/scanopy/server:latest
Last Updated2026-07-17
First Seen2025-12-20

Runtime arguments

Web UI
http://[IP]:[PORT:60072]
Network
bridge
Shell
bash
Privileged
false

Template configuration

AppdataPathrw
Target
/data
Value
/mnt/user/appdata/scanopy/server
PortPorttcp
Target
60072
Value
60072
Server Public URLVariable
Target
SCANOPY_PUBLIC_URL
Value
http://10.100.20.250:60072
Server PortVariable
Target
SCANOPY_SERVER_PORT
Value
60072
Database URLVariable

The full postgres URL to your database: postgresql://username:password@hostname:port/database

Target
SCANOPY_DATABASE_URL
Log LevelVariable
Target
SCANOPY_LOG_LEVEL
Value
info
Integrated Daemon URLVariable

Full URL of your Daemon instance (e.g. http://192.168.0.100:60073)

Target
SCANOPY_INTEGRATED_DAEMON_URL
Web External PathVariable
Target
SCANOPY_WEB_EXTERNAL_PATH
Value
/app/static