thedevs-network/kutt
Kutt
Kutt is a self-hosted URL shortening service built with Node.js and PostgreSQL. It allows users to create short links with custom aliases and expiration dates while managing them through a database-backed system. The service integrates OpenID Connect for user authentication and provides a RESTful API for programmatic link management.
The platform distinguishes itself through a custom domain router that maps incoming requests from user-defined domains to specific link records. It includes a dedicated administrative dashboard for branded link management and private analytics tracking to monitor visit statistics and traffic patterns.
Broad capabilities include user access control for restricting registration, a server-side rendered management interface, and integration options for browser extensions and external productivity tools. The system supports multiple relational databases, including SQLite, PostgreSQL, and MySQL.
The application is designed for zero-configuration deployment using environment variables for all settings.
Features
- URL Shorteners - Provides a complete self-hosted service for creating and managing shortened URLs with custom aliases.
- URL Shorteners - Provides a self-hosted service for creating, managing, and tracking shortened web links.
- Link Management - Ships a web-based management interface for viewing, editing, and deleting shortened links.
- Service Administration Panels - Provides a centralized administration panel to manage all users and shortened links.
- REST APIs - Exposes a RESTful API for the programmatic creation and management of short links.
- Short Link Management - Provides a programmatic API for the comprehensive management and lifecycle of shortened URLs.
- Link Configuration Options - Enables generation of short URLs with custom paths, passwords, and expiration dates.
- OIDC Authentication Plugins - Integrates with external identity providers for secure user authentication via the OpenID Connect protocol.
- Analytics Tracking - Tracks and displays detailed visit statistics and metadata for every shortened link.
- Domain Management - Supports the use of personal branded domains for professional short URL generation.
- Node.js Backend Services - Built with a Node.js server and PostgreSQL database for managing links and analytics.
- SQL Database Engine Support - Provides support for multiple relational databases, including SQLite, PostgreSQL, and MySQL.
- Zero-Configuration Deployments - Enables immediate operation without manual setup through environment-variable-driven configuration.
- Host Header Matchers - Routes requests to specific short links by inspecting the HTTP Host header for custom domains.
- Custom Domains - Enables the mapping of user-owned custom domains to the link shortening service.
- OpenID Connect Support - Supports user authentication through delegation to external identity providers via OpenID Connect.
- User Access Controls - Provides mechanisms to restrict link creation by disabling public registration.
- Environment Variable-Based Configuration - Configures all application settings using environment variables for a zero-config deployment experience.
- Request Interception Middleware - Implements a middleware pipeline to intercept redirect requests and log visit metadata for analytics.
- Link Visit Analytics - Provides private analytics tracking to monitor visit statistics and traffic patterns for each link.
- User Account Management - Includes tools for controlling user registration and administrative oversight of user accounts.
- Url Shorteners - Modern URL shortener with custom domain support.
- Open-source projects made by Iranian developers - Listed in the “Open-source projects made by Iranian developers” section of the Github Do Not Ban Us awesome list.
