# YOURLS

🔗 The 𝘥𝘦 𝘧𝘢𝘤𝘵𝘰 standard, self hosted, powerful and customizable, URL shortener in PHP

Repository: https://github.com/YOURLS/YOURLS
Canonical: https://ross.abutalabs.com/products/yourls
Homepage: https://yourls.org
Language: PHP
License: MIT
License Family: permissive
Topics: yourls, php, url-shortener, short-url, hacktoberfest, link-shortener, shorten-urls, shortener, urlshortener
Last push: 2026-08-24T13:54:15+00:00
Link (homepage): https://yourls.org
Link (site_page): https://yourls.org/docs
Link (site_page): https://yourls.org/docs/development/plugins
Link (site_page): https://yourls.org/docs/guide/install

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 61, longevity 100
- inputs: {"age_days": 5124, "days_push": 9, "days_rel": 102, "gap_med": 114.5, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 12177, forks 2077 (observed 2026-08-28T04:10:51.935815+00:00)

## What it is
YOURLS is a free, open-source PHP application for running your own URL shortener on your own server and domain. It provides an admin interface, a developer API, detailed click statistics and analytics, and an extensible plugin architecture.

## Use cases
- self-host a URL shortener on my own domain
- shorten links with full control over my data
- track click stats and referrers for short links
- create branded short URLs with a custom API
- extend a link shortener with plugins
- replace bit.ly with a private open-source alternative

## When to choose
- you want full ownership and control of your short links and data
- you need detailed click analytics, referrer tracking, and geo-location reports
- you want a PHP/MySQL stack with a plugin ecosystem and developer API
- you prefer free, open-source software with no service fees

## When to avoid
- you need a managed hosted solution with zero server maintenance
- your stack is not PHP or you cannot run Apache with mod_rewrite and MySQL/MariaDB
- you need enterprise features like SSO or multi-tenant link management out of the box

## Facets
- artifact type: application
- maturity: stable
- function: web-framework, api-framework, analytics, plugin-system, self-hosted
- domain: web-development, self-hosted, analytics, developer-tools
- platform: php, self-hosted, windows
- tags: url-shortener, link-shortening, click-tracking, mysql, mit-license, web-server, linux, macos

## Member repositories
- YOURLS/YOURLS (main) score 86
- YOURLS/awesome (docs) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:51.935815+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:14:52.323453+00:00, confidence not recorded.
  - readme: https://github.com/YOURLS/YOURLS (fetched 2026-08-28T04:10:51.935815+00:00, sha d0b0a5900853)
  - homepage: https://yourls.org (fetched 2026-08-29T08:12:20.171700+00:00, sha a14daf39b74d)
  - site_page: https://yourls.org/docs (fetched 2026-08-29T08:12:20.180797+00:00, sha f8fde1e51217)
  - site_page: https://yourls.org/docs/development/plugins (fetched 2026-08-29T08:12:20.182919+00:00, sha 5dc95ec11d85)
  - site_page: https://yourls.org/docs/guide/install (fetched 2026-08-29T08:12:20.185709+00:00, sha 10063e7b1479)
- Data as of 2026-08-30T08:39:29.467469+00:00.