58 lines
1.6 KiB
Markdown
58 lines
1.6 KiB
Markdown
# 🐾 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.
|