Short links under your control

Surls is a self-hosted system for short links, redirects, shared files, and privacy-aware click analytics.

Install Surls Explore features

Start here

• Check the requirements, then install with Docker Compose.
• Create your first link and review link management.
• Set up passkeys, 2FA, and external sign-in.
• Connect WordPress or the macOS share extension.

Surls runs as a Next.js application with PostgreSQL. This documentation site and surls.dev are built as static files for Cloudflare Pages; they do not host your short links or admin account. Choose your own domain for the Surls application and configure its BASE_URL to that origin.

The source repository contains the application, Compose files, and detailed operator guides. Use a pinned release image and read its release notes before updating.