itty.bitty

itty.bitty takes html (or other data), compresses it into a URL fragment, and provides a link that can be shared. When it is opened, it inflates that data on the receiver’s side.

Learn more at: about.bitty.site

How it works: how.bitty.site

For more info: wiki.bitty.site

Self-hosting

Local runtime prerequisites

Node.js 20 or newer
npm 9 or newer

Run locally

Install dependencies with npm install.
Start the server with npm run dev.
Visit http://localhost:8080.

Optional environment variables:

PORT: server port (defaults to 8080).
UA_ARRAY: comma separated list of User-Agents to block with HTTP 401.
REQUEST_LOG: set to silent to disable HTTP request logging.

Docker workflow

Build the image locally: docker build -t itty-bitty ..
Run the container: docker run --rm -d -p 8080:8080 --name itty-bitty itty-bitty.
Open http://localhost:8080/ in your browser.
Stop it with docker rm -f itty-bitty (or let --rm clean up if you stop the container normally).

Docker Compose

docker compose up --build -d

Stop the stack with docker compose down when you are done.

1.2 KiB Raw Blame History Unescape Escape