Skip to main content
If you prefer to run the components without Docker, the complete manual setup steps are in CONTRIBUTING.md. The same environment variables documented in Configuration apply.

Running each component

# Signaling server (Node.js)
cd server
npm install
npm start

# Web client (Next.js)
cd client
pnpm install
pnpm build
pnpm start

# CLI (optional, for local testing against your server)
cd cli
go build ./cmd/floe
./floe send photo.jpg --server http://localhost:3001
The client requires a production build (pnpm build then pnpm start) to serve static files. Use pnpm dev only during development, as it enables Next.js hot-reloading and is not suitable for production.

Environment variables

Copy and configure the environment files before starting:
cp server/.env.example server/.env
cp client/.env.example client/.env.local
Set at minimum:
  • In server/.env: CLIENT_URL=http://localhost:3000
  • In client/.env.local: NEXT_PUBLIC_SOCKET_URL=http://localhost:3001