← Toolshed
※ Docs · Self-hosting · No rent

SAFE HOUSE.

Pull TOOLSHED off the grid and onto your own box. One script, two flavors — Docker for the clean getaway, or bare-metal bun if you like to feel the pavement. Same tools. Same attitude. Now with your hostname on the door.

✓ 100% local✓ Zero telemetry✓ One command✓ Stop anytime
// The Setup
№00clone the joint

GRAB THE KEYS

First, you need the source. Clone it down, walk through the front door, and let the installer do the rest.

// clone & enter
git clone https://github.com/criticalconnections/toolshed.git toolshed
cd toolshed
№01containerized, clean exit

DOCKER ROUTE

The professional move. Builds an image, runs the container in the background on port 8665, auto-restarts unless you say otherwise. No fingerprints on your host system.

// docker getaway
./install.sh docker

Then point a browser at http://localhost:8665 and you're in business.

№02self-hosted with bun

BARE METAL

No containers, no middleman. The script checks for bun, offers to install it if it's missing, drops dependencies, and boots the dev server straight on your machine.

// run on the host
./install.sh self-hosted

Ctrl-C kills it. No daemons, no cron, no leftovers.

№03custom port

PICK YOUR DOOR

Default port is 8665. If that's already taken — or you just like a different number — set TOOLSHED_PORT before running.

// custom port
TOOLSHED_PORT=4040 ./install.sh docker

Or run with no arguments to get an interactive picker that prompts for mode and port.

// interactive
./install.sh
№04stop the container

CLEAN GETAWAY

When you're done, leave nothing behind. This stops and removes the container in one shot.

// stop docker
./install.sh stop

For self-hosted runs, just hit Ctrl-C in the terminal where it's running. That's the whole exit strategy.

№05receipts & caveats

THE SMALL PRINT

  • ▸ Bundle is a Cloudflare Workers build — bun run build if you want to deploy to Workers.
  • ▸ Self-hosted mode runs the Vite dev server (Workers runtime emulated). Fine for personal use.
  • ▸ Everything still happens in the user's browser — the server only ships HTML, CSS, and JS.
  • ▸ Need Docker? Get it at docker.com. Need bun? See bun.sh.