At a Glance:
Kutt is a self-hostable URL shortener designed for easy setup with no build step, supporting custom domains, multiple database backends (SQLite, Postgres, MySQL), private link statistics, and an admin panel for user and link management.
Overview:
Kutt is an open-source URL shortener that allows users to create, manage, and track shortened links. It is designed with self-hosting as a primary use case, offering a zero-configuration setup process and no required build step. Users can set custom URLs, passwords, descriptions, and expiration times for each link. The application includes private statistics for shortened URLs, an admin page for overseeing users and links, and the ability to use custom domains. It supports multiple database systems, including SQLite, PostgreSQL, and MySQL, and provides a RESTful API, making it suitable for individuals and developers who want to run their own link management service.
Key Decision Points:
Self-hosted and zero-config startup: Designed for easy self-hosting with no build step and a first-run admin account creation prompt.
Flexible database support: Works out-of-the-box with SQLite, but can also be configured to use PostgreSQL, MySQL, or MariaDB depending on deployment needs.
User and access management: Supports OpenID Connect (OIDC) login and provides the ability to disable public registration or anonymous link creation.
Link-level controls: Beyond shortening, users can set a custom path, password-protect a link, add a description, and define an expiration time.
Extensibility through API: A documented RESTful API is available for programmatic link creation and management, with community-built third-party packages in multiple languages.
Core Features:
Custom domain support: Allows short links to be served from a user's own domain name.
Private link statistics: Provides view counts and other statistics for each shortened URL.
Admin panel: A dedicated interface for administrators to manage all users and links on the instance.
OIDC authentication: Supports single sign-on through OpenID Connect providers.
Custom themes: Supports overriding default CSS, images, and HTML templates through a
/customdirectory for visual customization.Configurable link alphabet: Allows administrators to define the character set used for generating short URLs.
Use Cases:
Self-hosters wanting a link shortener: Individuals who want to run a short link service on their own infrastructure with control over data and domains.
Developers integrating URL shortening: Software developers who can integrate link creation and management into their applications using the RESTful API.
Teams needing a managed link service: Groups that can deploy a single instance, use OIDC for access, and have an admin manage users and monitor link activity.
Open-Source Alternative Value:
Kutt provides a self-contained, self-hosted alternative to commercial URL shortening services. Its value lies in being explicitly designed for self-hosting with minimal setup, requiring only Node.js and a supported database. Users gain control over link data and statistics while retaining the ability to use custom domains. The availability of a full REST API and configuration options to disable public registration or anonymous links makes it adaptable for private or internal use within a controlled environment.
