Most URL shorteners lock you into their ecosystem — your links, your data, and your analytics are controlled by someone else. Syano is different. As a fully open source URL shortener, you own everything.

Deploy in serverless or VPS infrastructure. Visit /dashboard to login and manage your links. Set login and settings from .env file.

• 🚫 Your links can disappear if the service shuts down
• 🚫 Analytics data is sold to third parties
• 🚫 Pricing changes can break your budget
• 🚫 Limited customization and branding
• 🚫 No control over uptime and performance

• ✅ Complete Data Ownership - Your links, your server, your rules
• ✅ Privacy-First Architecture - No tracking, no data selling
• ✅ Zero Recurring Costs - One-time setup, unlimited links forever
• ✅ Enterprise Features - Multi-user access, audit logs, advanced analytics
• ✅ Deploy Anywhere - Vercel, Netlify, Docker, VPS, or your own infrastructure
• ✅ Open Source Forever - AGPL-3.0 licensed, community-driven development

Syano isn't just a URL shortener — it's a comprehensive link management platform designed for teams, marketers, and developers who need professional-grade tools without the SaaS price tag.

Smart URL Shortening

• Intelligent slug suggestions based on URL analysis (combines domain & path consonants for meaningful abbreviations like gla or gledr)
• Custom slugs or auto-generated short links
• Live preview before saving
• Bulk import/export (JSON format)
• Real-time search across all link metadata
• Tag-based organization and filtering

Marketing & Campaign Tools

• Custom TRAI India SMS compliance Sender IDs with default selection support
• Built-in UTM parameter builder
• Link expiration scheduling
• Password-protected links
• Device-specific targeting (iOS/Android)
• Link cloaking with iframe embedding
• Custom redirect status codes (301/302/307)

Link Organization

• Hierarchical tag system
• Internal comments and notes
• Advanced search and filtering
• Sort by clicks, date, or custom criteria
• Batch import

Analytics

• Analytics for each link
• 24-hour and 7-day trend analysis and customer date range
• Export analytics data (CSV/JSON)

Geographic Intelligence

• Country, region, and city-level tracking
• Interactive world map visualization
• QR Scan Analytics
• Acquisition

Technology Analytics

• Browser and browser version tracking
• Operating system detection
• Device type classification (mobile/tablet/desktop)

Marketing Attribution

• Full UTM parameter tracking
• Referrer source analysis
• Acquisition channel breakdown

Analytics

• Activity heatmap (day × hour)
• Peak traffic time identification
• Click pattern analysis
• Recent events feed with real-time updates
• QR code scan tracking (separate from web clicks)

Professional QR Codes

• Instant QR code generation for every link
• SVG format (scalable, print-ready)
• PNG export for digital use
• Server-side rendering with 7-day caching
• Automatic QR scan tracking

Use Cases

• Print marketing materials
• Event tickets and badges
• Product packaging
• Restaurant menus
• Business cards

Personal Landing Pages

• Customizable bio page on your home page
• Profile photo and initials
• Bio text and description
• Unlimited custom links
• Social media icon row (20+ platforms)

Link Customization

• Custom titles and subtitles
• Icon selection from curated library
• Color accent customization
• Drag-and-drop reordering
• Show/hide individual links

Homepage Modes

• Default Syano landing page
• Custom redirect with delay
• Link-in-bio page
• Instant switching via dashboard

User Access Control

• Unlimited dashboard users
• Individual user accounts with secure authentication
• Enable/disable users without deletion
• User activity tracking in audit logs

Granular Permission System

• 4 preset roles: Viewer, Editor, Manager, Admin
• 10+ individual permissions
• Custom permission combinations
• Role-based access control (RBAC)
• Permission inheritance

Programmatic Access

• Full REST API for link management
• API key authentication with granular permissions
• OpenAPI-compatible endpoints
• Modern API documentation and API playground using Scalar

API Features

• Create, read, update, delete links
• Bulk link creation
• Analytics data export
• Tag management
• Search across links

Integration Examples

• Zapier workflows
• Make.com (Integromat) scenarios
• n8n automation
• Custom applications
• CI/CD pipelines
• Slack/Discord notifications

Supported Databases:

• PostgreSQL (local or self-hosted)
• Neon (serverless PostgreSQL)
• Supabase (PostgreSQL as a service)
• Aiven (managed PostgreSQL)
• AWS RDS, Google Cloud SQL, Azure Database
• Docker PostgreSQL containers

Modern Interface

• Clean, intuitive dashboard
• Full dark mode support
• Responsive design (mobile, tablet, desktop)
• Real-time updates

Developer Experience

• TypeScript throughout
• Type-safe database queries (Drizzle ORM)
• Comprehensive API documentation
• Easy local & cloud setup
• One click database update
• Easy database migration from dashboard

Get your self-hosted URL shortener running in under 5 minutes.

• Node.js 18 or higher
• PostgreSQL 14 or higher
• pnpm (recommended)

git clone https://github.com/pritush/syano.git
cd syano
pnpm install

cp .env.example .env

Edit .env with your configuration:

# Database Connection
# For serverless (Netlify/Vercel): Use Neon pooled connection
DATABASE_URL=postgresql://user:[email protected]/db?sslmode=require

# For traditional servers (VPS/Docker): Use direct connection
# DATABASE_URL=postgresql://user:pass@localhost:5432/syano

# Authentication (for login /dashboard)
NUXT_SITE_TOKEN=your-secure-random-token-here
NUXT_SITE_USER=root

# Optional: Connection Pool Tuning
# DB_POOL_MAX=20
# DB_POOL_MIN=2

# Optional: Application Settings
# NUXT_CACHE_TTL=30
# NUXT_REDIRECT_STATUS_CODE=301
# NUXT_PUBLIC_SLUG_DEFAULT_LENGTH=6

Option A: Local PostgreSQL

createdb syano
psql -d syano -f database/schema.sql

Option B: Docker PostgreSQL

docker run -d \
  --name syano-db \
  -e POSTGRES_PASSWORD=password \
  -e POSTGRES_DB=syano \
  -p 5432:5432 \
  postgres:16-alpine

docker exec -i syano-db psql -U postgres -d syano < database/schema.sql

Option C: Cloud Database (Neon, Supabase)

# Copy the SQL from database/schema.sql and run it in your cloud database console
# Or use psql with your cloud connection string
psql -d "your-cloud-connection-string" -f database/schema.sql

Verify Database Setup:

pnpm run db:check-audit

pnpm dev

Visit http://localhost:7466 and login with your NUXT_SITE_TOKEN.

Deploy your self-hosted URL shortener to any platform in minutes.

# Install Netlify CLI
npm install -g netlify-cli

# Deploy
pnpm run build
netlify deploy --prod

Environment Variables:

• DATABASE_URL - Use Neon pooled connection (-pooler suffix)
• NUXT_SITE_TOKEN - Your secure token
• NUXT_SITE_USER - Admin username (default: root)
• NUXT_PUBLIC_SITE_URL - your domain where the script is hosted

• Track campaign performance with UTM parameters
• A/B test different landing pages
• Monitor geographic reach
• Analyze device and browser trends
• Generate QR codes for offline campaigns

• Self-hosted alternative to Bitly, TinyURL, Short.io
• REST API for programmatic link creation
• Webhook integrations with Zapier, Make.com, n8n
• Custom domain support
• White-label solution
• CI/CD pipeline integration
• Automated link generation from deployments

• Multi-user access with role-based permissions
• Audit logs for compliance
• Centralized link management
• Team collaboration features
• Secure password-protected links

• Link-in-bio pages for social media
• Track audience engagement
• Organize links by campaign or topic
• Professional QR codes for merchandise
• Analytics for content performance

Frontend:

• Nuxt 3 - Vue.js meta-framework
• Nuxt UI - Beautiful UI components
• Tailwind CSS - Utility-first CSS
• Chart.js - Analytics visualizations
• D3.js - Geographic data visualization
• Scalar - API documentation and API playground

Backend:

• Node.js - JavaScript runtime
• Drizzle ORM - Type-safe database queries
• PostgreSQL - Relational database

• No Third-Party Tracking - Your data never leaves your server
• No Analytics Selling - Your insights remain private
• Self-Hosted - Complete data sovereignty

Experience Syano in action:

Demo Instance: https://syano.vercel.app

Test Links:

• https://syano.vercel.app/gmap
• https://syano.vercel.app/smo5r
• https://syano.vercel.app/jubfz
• https://syano.vercel.app/klcvx

Found a bug or have a feature request? Open an issue on GitHub.

Syano is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

This means:

• ✅ Free to use, modify, and distribute
• ✅ Open source forever
• ✅ Commercial use allowed
• ⚠️ Must disclose source code if you modify and deploy

See the LICENSE file for full details.

Syano vs. other URL shorteners:

• vs. Bitly - Self-hosted, no monthly fees, unlimited links
• vs. TinyURL - Advanced analytics, team management, audit logs
• vs. Short.io - Open source, full data ownership, no vendor lock-in
• vs. Rebrandly - Free forever, customizable, privacy-first

Yes! Syano is 100% free and open source under the AGPL-3.0 license. No hidden costs, no premium tiers, no feature limitations.

Absolutely! Deploy Syano on any domain you own. Perfect for branded short links like yourbrand.link/promo.

Unlimited. There are no artificial limits on links, clicks, or users.

Yes! Syano is production-ready with features like connection pooling, caching, health checks, and audit logging.

Yes! Use the bulk import feature to migrate your existing links. Export from your current service and import into Syano.

Syano is optimized for performance with database indexing, connection pooling, and caching. It handles thousands of redirects per second on modest hardware.

Basic command-line knowledge is helpful for deployment, but the dashboard is user-friendly and requires no coding.

Yes! Syano is fully customizable. Modify the source code, add your branding, or contribute themes back to the community.

Project by Pritush