# 🐾 Toes

Toes is a personal web server you run in your home.

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

## setup

Toes runs on a Raspberry Pi. You'll need:

- A Raspberry Pi running Raspberry Pi OS
- A `toes` user with passwordless sudo

SSH into your Pi as the `toes` user and run:

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

This will:

1. Install system dependencies (git, fish shell, networking tools)
2. Install Bun and grant it network binding capabilities
3. Clone and build the toes server
4. Set up bundled apps (clock, code, cron, env, stats, versions)
5. Install and enable a systemd service for auto-start

Once complete, visit `http://<hostname>.local` on your local network.

## features
- Hosts bun/hono/hype webapps - both SSR and SPA.
- `toes` CLI for pushing and pulling from your server.
- `toes` CLI for local dev mode.
- https://toes.local web UI for managing your projects.
- Per-branch staging environments for Claude.

## cli configuration

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

```bash
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
```

set `NODE_ENV=production` to default to `toes.local:80`.

## fun stuff

- textOS (TODO, more?)
- Claude that knows about all your toes APIS and your projects.
- non-webapps

## february goal

- [ ] Corey and Chris are running Toes servers on their home networks, hosting personal projects and games.
