selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

The-One-File logo

Self-host The-One-File

TOFV-2.0

Visual topology mapper in a single portable HTML file

ReleaseOpen SourceOther
Updated4 months ago
LanguageHTML
Setup difficultyEasy
MobileResponsive
Stars
548
Port
10101 (TheOneFile_Verse collaboration server)
Docker
ghcr.io/gelatinescreams/theonefile_verse
Install with Docker
Corporate network topology viewRouting topology viewCorporate preview animationRouting preview animationHomelab preview animationMobile interface previewsMulti-user collaboration preview

What is The-One-File?

The One File is a browser-based visual planning tool for creating network topologies, infrastructure diagrams, rack layouts, and mind maps. It ships as a single HTML file that works completely offline, saves all data into itself, and optionally encrypts content with AES-256-GCM. Three editions exist: Core (pure offline), Networkening (adds live status monitoring and icon libraries), and TheOneFile_Verse (a Docker wrapper enabling real-time multi-user collaboration on port 10101). Features include free-form drawing, per-breakpoint styling, rack U-unit views, layer filtering, bulk operations, keyboard shortcuts, touch-optimized mobile UI, and recording/playback of changes. No server or database is required for the Core and Networkening editions; TheOneFile_Verse runs via Docker Compose with a single volume for persistence.

Should you self-host The-One-File?

The-One-File scores 52/100 on selfhost.directory (how scoring works) and ranks #18 of 34 in Network Management. It has 548 GitHub stars.

It shipped 10 stable releases in the past year. The latest, TOFV-2.0, came out on 7 June 2026. New versions land roughly every 8 days.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Other-licensed and written mostly in HTML.

Its closest alternative on selfhost.directory is 3x-ui (84/100, 48 772 stars). It scores higher overall, so compare the two before you pick. See The-One-File vs 3x-ui side by side.

Features

  • AES-256-GCM encryption
  • Bulk Operations
  • Free-form drawing
  • Icon librariesNetworkening and Verse editions
  • Keyboard Shortcuts
  • Layer system
  • Live network monitoringNetworkening edition only
  • Network discovery and service detectionTheOneFile_Verse edition
  • Network Topology Mapping
  • Rack U-unit visualization
  • Real-time multi-user collaborationTheOneFile_Verse edition only
  • Recording and playback
  • Single-file offline operationCore and Networkening editions

The-One-File README

How to install The-One-File

Install The-One-File with Docker

Environment variables
PORT, DATA_DIR, REDIS_URL, CORS_ORIGIN, REQUIRE_WS_TOKEN, TRUSTED_PROXY_COUNT, TRUSTED_PROXIES, DEBUG_OIDC

docker run -d -p 10101:10101 -v theonefile-data:/app/data ghcr.io/gelatinescreams/theonefile_verse:latest

TheOneFile_Verse collaboration server

How to configure The-One-File

  • CORS_ORIGINComma separated list of allowed origins

    Comma separated list of allowed origins

  • DATA_DIR./dataWhere settings and room data are stored

    Where settings and room data are stored

  • DEBUG_OIDCfalseEnable OIDC debug logging (dev only)

    Enable OIDC debug logging (dev only)

    values: true, false

  • PORT10101Server port

    Server port

  • REDIS_URLOptional Redis connection for scaling

    Optional Redis connection for scaling

  • REQUIRE_WS_TOKENtrueRequire WebSocket session tokens. Set to false only for trusted local testing

    Require WebSocket session tokens. Set to false only for trusted local testing

    values: true, false

  • TRUSTED_PROXIESComma separated list of trusted proxy IPs

    Comma separated list of trusted proxy IPs

  • TRUSTED_PROXY_COUNT0Number of trusted reverse proxies. Defaults to 0, meaning X Forwarded For is ignored

    Number of trusted reverse proxies. Defaults to 0, meaning X Forwarded For is ignored

The-One-File releases & version history

More in Diagramming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…