gitwtfhub

wtf is omnishare?

frum1/omnishare — explained in plain English

Analysis updated 2026-05-18

6PythonAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

TL;DR

A self-hosted file sharing server that gives every uploaded file both a public internet link and a fast local network link.

Mindmap

mindmap
  root((OmniShare))
    What it does
      Dual share links
      Resumable uploads
      Link expiry limits
    Tech stack
      Python
      Docker
      Vue 3
      Caddy
      SQLite
    Use cases
      Share files on home network
      Share files publicly with a link
      Self host instead of cloud storage
    Audience
      Self hosters
      Home network users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Share a large file with someone on the same home network at full local speed

REASON 2

Share a file publicly over the internet with an expiring, unauthenticated link

REASON 3

Self host a private file sharing service instead of using a third-party cloud service

REASON 4

Run a multi-user file sharing server with per-user storage quotas

What's in the stack?

PythonDockerVue 3SQLiteCaddy

How it stacks up

frum1/omnishareaclark4life/home-depot-crawlaetheria-labs1/storefront-skills
Stars666
LanguagePythonPythonPython
Last pushed2014-08-10
MaintenanceDormant
Setup difficultymoderatemoderateeasy
Complexity3/52/53/5
Audienceops devopsdeveloperpm founder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Docker and, for public HTTPS access, a domain with ports 80 and 443 forwarded.

Free to use and modify, but any modified version you distribute must also be released under the same open license.

Wtf does this do

OmniShare is a self-hosted file sharing tool built for a specific everyday problem: sending a file to someone on your home network should not have to travel out to the internet and back. Most file sharing services only give a file one link, which either only works locally or only works from outside. OmniShare gives every uploaded file two links at once, a public one that works over the internet and a local one that works directly over your home network, and lets you pick whichever one fits the person you are sending it to. The tool runs as a single self-hosted server. Uploading a file requires a user account, since there is no open sign-up, and an admin creates accounts with their own storage limits from an admin panel. Downloading a file does not require an account at all, anyone with the link can grab the file, so links themselves act as the access control, and files can optionally be given an expiry time or a download limit for extra safety. Large uploads use a protocol that lets them resume automatically if the connection drops partway through. Behind the scenes, OmniShare bundles an optional reverse proxy called Caddy that can automatically get and renew a free HTTPS certificate for a public domain, while devices inside the home network reach the server directly by its local address without going through the internet at all. The whole setup runs from a Docker container using a lightweight SQLite database, so no separate database server is needed, and settings can be changed later from the admin panel itself. Getting started only requires Docker: downloading two configuration files, setting the server's local network address in an environment file, and running one command to start it. On first startup the server automatically creates an administrator account with a generated password. The project is written in Python, uses a Vue-based web interface built as a companion project, and is released under the GPL version 3 license.

Yoink these prompts

Prompt 1
Help me deploy OmniShare using Docker Compose on my home server
Prompt 2
Explain how OmniShare's dual public and local links work
Prompt 3
Show me how to set up the bundled Caddy reverse proxy for HTTPS in OmniShare
Prompt 4
Walk me through resetting the admin password in OmniShare
Prompt 5
Explain the difference between OmniShare's upload and download access model

Frequently asked questions

wtf is omnishare?

A self-hosted file sharing server that gives every uploaded file both a public internet link and a fast local network link.

What language is omnishare written in?

Mainly Python. The stack also includes Python, Docker, Vue 3.

What license does omnishare use?

Free to use and modify, but any modified version you distribute must also be released under the same open license.

How hard is omnishare to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is omnishare for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.