v0.1.0

TSFlow v0.1.0

A modern web application for visualizing and analyzing network traffic flows within Tailscale networks.

🐳 Docker Installation (Recommended)

Quick Start:

# Create environment file
curl -o .env https://raw.githubusercontent.com/rajsinghtech/tsflow/main/env.example
# Edit .env with your Tailscale credentials

# Run with Docker
docker run -d \
  -p 8080:8080 \
  --env-file .env \
  --name tsflow \
  ghcr.io/rajsinghtech/tsflow:v0.1.0

Docker Compose:

# Download and extract release
wget https://github.com/rajsinghtech/tsflow/releases/download/v0.1.0/tsflow-v0.1.0.tar.gz
tar -xzf tsflow-v0.1.0.tar.gz
cd tsflow-v0.1.0

# Configure environment
cp env.example .env
# Edit .env with your credentials

# Run with Docker Compose
docker-compose up -d

📦 Manual Installation

Binary Installation:

1. Download the appropriate binary for your platform from the assets below
2. Download the frontend build: tsflow-frontend-v0.1.0.tar.gz
3. Extract frontend: tar -xzf tsflow-frontend-v0.1.0.tar.gz
4. Set environment variables (see env.example)
5. Run the binary: ./tsflow-<platform>

Supported Platforms:

• Linux (amd64, arm64)
• macOS (amd64, arm64)
• Windows (amd64)

🛠 Development Setup

git clone https://github.com/rajsinghtech/tsflow.git
cd tsflow

# Backend
cd backend && go mod download && go run main.go &

# Frontend  
cd frontend && npm install && npm run build

📋 What's Included

• Go Backend: High-performance API server with Tailscale integration
• React Frontend: Modern web interface with real-time visualization
• Docker Support: Production-ready containerization
• Multi-platform Binaries: Native builds for all major platforms

🚀 Features

• Real-time network topology visualization
• Comprehensive traffic analytics and filtering
• Device management and monitoring
• No CORS issues (backend handles all API calls)
• Production-ready architecture

v0.0.3

TSFlow v0.0.3

Docker Installation

docker pull ghcr.io/rajsinghtech/tsflow:latest
docker run -p 8080:8080 \
  -e TAILSCALE_ACCESS_TOKEN="your-token" \
  -e TAILSCALE_TAILNET="your-tailnet" \
  ghcr.io/rajsinghtech/tsflow:latest

Binary Installation

Download the appropriate binary for your platform from the assets below.

v0.0.2

TSFlow v0.0.2

Docker Installation

docker pull ghcr.io/rajsinghtech/tsflow:latest
docker run -p 8080:8080 \
  -e TAILSCALE_ACCESS_TOKEN="your-token" \
  -e TAILSCALE_TAILNET="your-tailnet" \
  ghcr.io/rajsinghtech/tsflow:latest

Binary Installation

Download the appropriate binary for your platform from the assets below.

v0.0.1

TSFlow v0.0.1

Docker Installation

docker pull ghcr.io/rajsinghtech/tsflow:latest
docker run -p 8080:8080 \
  -e TAILSCALE_ACCESS_TOKEN="your-token" \
  -e TAILSCALE_TAILNET="your-tailnet" \
  ghcr.io/rajsinghtech/tsflow:latest

Binary Installation

Download the appropriate binary for your platform from the assets below.