localgo

LocalGo

A Go implementation of the LocalSend v2.1 protocol for secure, cross-platform file sharing.

Features

• Complete LocalSend v2.1 Protocol - Works with LocalSend apps
• Secure - HTTPS with certificates, optional PIN protection
• Fast Discovery - Multicast UDP + HTTP fallback
• Multi-file Transfers - Send multiple files concurrently
• Web Share - Share files via browser download link
• Metadata Preserved - File timestamps preserved on transfer
• Cross-Platform - Linux, macOS, Windows

Quick Start

Installation

# User installation (recommended)
./scripts/install.sh

# System-wide with systemd
sudo ./scripts/install.sh --mode system --service --create-user

Usage

# Start server to receive files
localgo-cli serve

# Discover devices
localgo-cli discover

# Send a file
localgo-cli send --file document.pdf --to "My Phone"

# Share files for web download
localgo-cli share --file document.pdf

Docker

# Start with Docker Compose
docker-compose up -d

# Or build and run manually
docker build -t localgo .
docker run -d --network host -v $(pwd)/downloads:/app/downloads localgo

Configuration

Environment Variables

Example

export LOCALSEND_ALIAS="File Server"
export LOCALSEND_DOWNLOAD_DIR="/srv/files"
export LOCALSEND_PIN="123456"
localgo-cli serve

Commands

Run localgo-cli help for more options.

Documentation

Detailed guides available in docs/:

• Configuration - All settings
• Docker - Container deployment
• CLI Reference - Command details
• Deployment - Production setup

Troubleshooting

Discovery not working:

# Use HTTP scan instead
localgo-cli scan --timeout 15

Port in use:

# Use different port
localgo-cli serve --port 8080

Permission denied:

# Fix download directory
chmod 755 ~/Downloads/LocalGo

License

MIT License - see LICENSE file.