Self-hosted professional network graph — map people, companies, and how you met them on an interactive force-directed canvas.
Netweave is a single-user, local-first tool. Your network lives in your own database, on your machine or server — not on a shared social platform.
The fastest way to run your own instance:
git clone https://github.com/owenmoloney/Netweave.git
cd netweave
# Set a strong secret before running in production
export JWT_SECRET="your-random-64-char-secret"
docker compose up -dOpen http://localhost:8080, register an account, and start mapping your network.
To stop: docker compose down (your data is kept in the netweave-data Docker volume).
git clone https://github.com/owenmoloney/Netweave.git
cd netweave
npx pnpm@9 install
cp server/.env.example server/.env
cp client/.env.example client/.env
cd server && npx pnpm@9 db:migrate && cd ..
npx pnpm@9 dev- Client: http://localhost:5173
- API: http://localhost:3001
See docs/DEVELOPMENT.md for tests, demo credentials, and architecture.
After a conference or meetup
- Click + → Add Person — name, title, optional company
- Open their detail panel → Add Connection — record how/where you met, date, and context
- Set strength (1–5) to signal follow-up priority
Ongoing
- Link people to Company nodes to see clusters form on the canvas
- Press Cmd+K (Mac) or Ctrl+K (Windows/Linux) to fuzzy-search anyone in your network
- Drag nodes to arrange the graph; positions auto-save
- Click a node to browse all their connections and jump between contacts
- All contact data is stored in a SQLite database you control
- Each instance is private to one user account — no multi-tenant sharing
- Change
JWT_SECRETbefore exposing the app beyond localhost - Use HTTPS if you deploy to a public URL
Docker: the database file lives in the netweave-data volume at /data/netweave.db inside the container.
# Example: copy DB to your machine
docker compose cp netweave:/data/netweave.db ./netweave-backup.dbLocal dev: copy server/prisma/dev.db (or your configured DATABASE_URL path) regularly.
For cloud hosting (Render, Railway, etc.), persistent storage, and production environment variables, see docs/DEPLOYMENT.md.
Contributions are welcome! See CONTRIBUTING.md.
Report security issues per SECURITY.md — do not file public issues for vulnerabilities.