🐾 Toes

Personal web appliance you run on your home network.

Plug it in, turn it on, and forget about the cloud.

Development

bun run dev      # Hot reload (rebuilds client bundle on change)
bun run start    # Production mode
bun run check    # Type check
bun run test     # Tests
bun run build    # Build client JS bundle
bun run release  # Build a release tarball for the Pi

Releasing

bun run release builds everything the Pi needs into a single tarball:

Client JS bundle (pub/client/index.js)
Embedded templates (src/lib/templates.data.ts)
Pre-built bare git repos for bundled apps (dist/repos/)
Cross-compiled CLI binary for linux-arm64 (dist/toes)

Output: dist/toes-<version>.tar.gz

The Pi does zero building — it untars, runs bun install, and starts. Upload the tarball to wherever RELEASE_URL in install/install.sh points (currently https://toes.dev/release/latest.tar.gz).

Scripts

Script	What it does
`scripts/build.sh`	Builds the client JS bundle into `pub/client/index.js`
`scripts/build-repos.sh`	Pre-builds bare git repos for bundled apps in `dist/repos/`
`scripts/release.sh`	Full release: client + templates + repos + CLI → tarball
`scripts/build.ts`	Builds the CLI binary (current platform or cross-compile)
`scripts/embed-templates.ts`	Generates `src/lib/templates.data.ts` from `templates/`
`scripts/setup-ssh.sh`	Configures SSH access for the `cli` user on the Pi
`scripts/remote-install.sh`	Runs the installer on a remote Pi over SSH

Setup

Toes runs on a Raspberry Pi 5 with a toes user and passwordless sudo.

curl -fsSL https://toes.dev/install | bash

The installer downloads the release tarball, installs bun and system packages, runs bun install for the server and all bundled apps (in parallel), copies the pre-built CLI and git repos into place, and starts the systemd service.

Dashboard: http://<hostname>.local

Features

Hosts Bun/Hype webapps (SSR and SPA)
git push Heroku-style deploys
Web dashboard with real-time status, logs, and tools
toes CLI (local install or SSH)
Per-app environment variables, cron jobs, metrics
Public sharing via tunnels

SSH CLI

Manage your server from any machine on the network — no install required.

ssh cli@toes.local           # interactive shell with tab completion
ssh cli@toes.local list      # run a single command
ssh cli@toes.local logs fog  # stream logs for an app

CLI Configuration

By default, the CLI connects to localhost:3000 in dev and toes.local:80 in production.

toes config                                  # show current host
TOES_URL=http://192.168.1.50:3000 toes list  # connect to IP
TOES_URL=http://mypi.local toes list         # connect to hostname

2.8 KiB Raw Blame History