1. TheOneFile
  2. TheOneFile_Verse
TheOneFile_Verse 2.1.0

As it turns out, there can be more than one

TheOneFile_Verse is a self hosted, Docker based server that wraps TheOneFile in real time multiplayer. Bring your whole clan into the same map, live, in 2D, 3D (beta) and VR (alpha). Rooms save themselves, and everything stays on your hardware.

Duncan and Methos move nodes while Connor watches it happen. Recorded in a real TheOneFile_Verse room.

Summon TheOneFile_Verse

One command starts TheOneFile_Verse on port 10101 with its data on a named volume.

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

Then open http://localhost:10101 and create the admin account.

Or with Compose

Compose file
services:
  theonefile_verse:
    image: ghcr.io/gelatinescreams/theonefile_verse:latest
    ports:
      - "10101:10101"
    volumes:
      - ./data:/app/data
    environment:
      - PUBLIC_URL=https://verse.example.com
    restart: unless-stopped

Run docker compose up -d. Set PUBLIC_URL so password reset and magic link emails send. The full compose file with Redis is in the repository.

Built for a clan, not a cloud

Rooms that save themselves

Every change syncs live and is merged field by field, so a stale copy can never undo someone else’s work. Optional room passwords, view only rooms and self destruct timers.

Undo for everyone

Undo and redo rebuilt for 2D, 3D (beta) and VR (alpha), with chat, cursor sharing and name changes you can switch off from the admin panel.

Accounts your way

Open, invite only, approval required or SSO only sign up. Two factor authentication with backup codes, and active session lists with sign out everywhere.

Single sign on

Sign in with Authentik, Google, GitHub, Microsoft or any OIDC provider, and link several providers to one account.

Roles that the server enforces

Owner, admin, editor, guest and viewer. Every change is checked on the server, so a view only room is truly view only.

Network discovery

Scan a subnet, find hosts across 70+ common ports, auto tag services and pull them onto the map with selfh.st icons.

Admin panel

Rooms, users, invites, backups with retention, audit and activity logs, API keys, webhooks and instance limits in one place.

3D (beta) and VR (alpha) in every room

Enter 3D (beta) turns the map into a walkable, editable room. On an HTTPS instance, step inside with a Quest 3. Walk TheOneFile_Verse

Locked down

Secrets encrypted with AES 256 GCM, server side request protection on probes and webhooks, a parse5 backed sanitizer, CSRF checks and guest storage limits.

See it before you run it

The admin demo runs in your browser with sample data.

TheOneFile_Verse questions

Does TheOneFile_Verse need Redis?

No. TheOneFile_Verse runs with an in memory fallback. Redis is optional and only needed when more than one TheOneFile_Verse process serves the same rooms.

Can I keep TheOneFile_Verse on a pinned build of TheOneFile?

Yes. Set SKIP_UPDATE=true and TheOneFile_Verse will not fetch a newer app file on boot.

Can I turn 3D (beta) off?

Yes. The enable3d admin setting removes the 3D (beta) script and every 3D (beta) route.

Is TheOneFile_Verse free?

Yes. Like TheOneFile, it is released under the Unlicense.