selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

AI Shortlink logo

Self-host AI Shortlink

issue-2-saas-verified-20260905

URL shortener and live QR platform you host yourself

BetaOpen SourceAGPL-3.0
Updated9 hours ago
LanguageGo
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
168
Port
8080 (HTTP listener)
Install with Docker Compose

What is AI Shortlink?

AI Shortlink is a self-hosted platform for managing short links and live QR codes as long-term, controllable entry points. It provides custom short codes with configurable redirect policies (301/302/307/308), schedules, visit limits, and fallback URLs. Live QR entries support multiple QR code pools with rotation strategies (round-robin, weighted random, least-shown). Branded QR codes offer classic, rounded, and dot styles with custom colors and center logos, exportable as SVG, PNG, or WEBP. The system includes multi-user ownership where regular users manage only their own resources while administrators review and approve all entries before they go live. Authentication uses Magic Link (email), GitHub OAuth, trusted-browser one-click login, and recovery keys. Analytics cover 30-day trends, unique IPs, device and browser breakdowns, and QR display/long-press intent. Deployment options include Docker Compose with embedded SQLite, Docker with bundled MariaDB, a native Linux amd64 binary with systemd, and Render. The codebase is a single Go 1.23+ service with embedded frontend assets and no external model dependencies in the current version. Licensed under AGPL-3.0-only.

Should you self-host AI Shortlink?

AI Shortlink scores 43/100 on selfhost.directory (how scoring works) and ranks #16 of 23 in URL Shortener. It has 168 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. It is AGPL-3.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is dub-links (74/100, 24 961 stars). It scores higher overall, so compare the two before you pick. See AI Shortlink vs dub-links side by side.

Features

  • Analytics Dashboard
  • Audit Logging
  • Branded QR codes
  • Custom short codes
  • Email notifications
  • GitHub OAuth authentication
  • Internationalization
  • Link scheduling and limits
  • Live QR codes with rotation
  • Magic Link Authentication
  • Multi-user ownership with admin review
  • Recovery keys
  • Trusted browser login

AI Shortlink README

How to install AI Shortlink

Install AI Shortlink with Docker Compose

Docker and Docker Compose
Environment variables
APP_ADDR, DATA_DIR, TRUST_PROXY, COOKIE_SECURE, APP_SECRET, SESSION_TTL_HOURS, UPLOAD_MAX_MB, GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET

git clone https://github.com/flyfish-dev/shortlink.git cd shortlink cp .env.example .env docker compose up -d --build

Uses embedded SQLite by default; add --profile mysql for MariaDB

How to configure AI Shortlink

  • APP_ADDR:8080HTTP listener address

    HTTP listener address

  • APP_SECRETGenerated and persistedCookie signing, recovery-key encryption, and hashing

    Cookie signing, recovery-key encryption, and hashing

  • COOKIE_SECUREfalseRequire HTTPS for authentication cookies

    Require HTTPS for authentication cookies

    values: true/false

  • DATA_DIR./dataDatabase, uploads, and runtime configuration directory

    Database, uploads, and runtime configuration directory

  • GITHUB_CLIENT_IDOptional GitHub OAuth application client ID

    Optional GitHub OAuth application client ID

  • GITHUB_CLIENT_SECRETOptional GitHub OAuth secret

    Optional GitHub OAuth secret

  • SESSION_TTL_HOURS87600Trusted-browser session lifetime

    Trusted-browser session lifetime

  • TRUST_PROXYfalseTrust proxy client-IP headers only behind a controlled proxy

    Trust proxy client-IP headers only behind a controlled proxy

    values: true/false

  • UPLOAD_MAX_MB8Maximum uploaded QR image size

    Maximum uploaded QR image size

More in URL Shortener

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…