YOURLS URL Shortener

AWS Developer Tools

YOURLS, the self hosted URL shortener that keeps your short links and their click analytics on infrastructure you control.

Base
Hardened build
minimal ports, security patches applied at build time
Access
Unique credentials
generated on first boot, readable only by root
Verified
Boots working
services pass a health gate before release
Support
24/7, 365 days
by email and live chat, 24 hour response SLA

Overview

YOURLS (Your Own URL Shortener) is an established open source link shortener you run yourself. It turns long URLs into short ones under your own domain, letting you either auto generate a keyword or choose your own, so a link can read as something meaningful rather than as a random string. Every link you create is tracked: YOURLS records each click and reports hits over time, the referrer sources sending traffic, and a country breakdown, so the analytics that a hosted shortener would keep for itself stay with you.

Beyond the admin interface it offers a bookmarklet for shortening the page you are reading, a full REST API for creating and querying links from your own code, and a plugin system for extending its behaviour. It suits anyone who wants short links without handing their traffic data to a third party: marketing and communications teams publishing campaign links, publishers and developers who want branded links under a domain they own, and anyone replacing a hosted shortener that could rate limit, expire, or discontinue the links they depend on.

Why the cloudimg image

cloudimg delivers YOURLS fully installed with its web server, PHP runtime and database, so a working shortener answers the moment the instance boots and the installer is already completed. Short link routing is configured in the web server itself rather than left to the rewrite rules upstream generates, which a default web server configuration silently ignores, so links resolve correctly from the first boot instead of returning not found. The image carries no usable credential: on the first boot of every instance a one shot service generates a database password and an administrator password unique to that instance, writing the password to a file only the root user can read and storing it in the configuration only as a bcrypt hash. The application follows whatever address you browse it on, so it works on the instance address immediately and keeps working after you attach your own domain or the address changes, with no configuration edit. Your links and click analytics live on a dedicated data volume kept separate from the operating system disk. The base is fully patched with unattended security upgrades enabled, and every deployment is paired with a step by step deploy guide and backed by 24/7 cloudimg support.

Common uses

  • Branded short links under a domain you own
  • Campaign link tracking with click analytics you keep
  • Replacing a hosted shortener with a private API driven one

Key features

  • YOURLS 1.10 link shortener fully installed with PHP 8.3, Apache and MariaDB - deploy a working branded shortener in minutes, not hours. The installer is pre-completed and short-URL routing is configured in the web server, so links resolve correctly from first launch. Backed by an active open source community and plugin ecosystem. Browse to your instance address, sign in, and start shortening links immediately.
  • Security hardened with unique per-instance credentials generated on first boot. MariaDB and YOURLS administrator passwords are created fresh for every deployment and stored in a root-only file, with the administrator password kept only as a bcrypt hash, and the database listening only on the loopback interface. Your links and click analytics live on a dedicated data volume separate from the OS disk for data isolation and simpler backup.
  • 24/7 expert technical support from cloudimg with a one-hour average response time for critical issues. Our engineers provide YOURLS-specific assistance including deployment guidance, custom domain and TLS setup, plugin and REST API configuration, version upgrades, performance tuning, and MariaDB database administration.

See it running

Real screenshots taken while testing this image against its deployment guide.

YOURLS URL Shortener screenshot 1 YOURLS URL Shortener screenshot 2 YOURLS URL Shortener screenshot 3 YOURLS URL Shortener screenshot 4

Description

This is a repackaged open source software product wherein additional charges apply for cloudimg support services.

Overview

Eliminate hours of manual dependency installation, web server configuration and database setup. This image delivers YOURLS (Your Own URL Shortener) fully installed, configured and security hardened, so you have a working branded link shortener within minutes of launch. The current release available is YOURLS 1.10.

Why self-hosted YOURLS

Third-party link shorteners own your click data, limit custom domains on free tiers, and charge escalating fees as volume grows. Running YOURLS on your own AWS infrastructure gives you full ownership of every click analytics row, unlimited custom domains, no per-link fees, and complete REST API access, all on infrastructure you control. YOURLS is a well-established open source project with an active community and a rich plugin ecosystem; this image packages the current release into a production-ready deployment so you benefit from that ecosystem without the setup burden.

Application stack

YOURLS runs on PHP 8.3 with OPcache and all required extensions, served by Apache with a TLS-ready configuration, with MariaDB as the database. Short link routing is configured in the web server rather than left to rewrite rules a default configuration ignores, so links resolve correctly the moment you launch. Your data, the MariaDB database holding every short link and every click analytics row plus the YOURLS configuration and any plugins you add, lives on a dedicated data volume kept separate from the operating system disk.

Secure by default

On the first boot of your instance a one-shot service generates a fresh MariaDB password and a fresh YOURLS administrator password unique to that instance and writes them to a root-only file. No shared or default passwords ship in the image. The administrator password is stored only as a bcrypt hash, and the database listens only on the loopback interface.

Ready to use

The application follows whatever address you browse it on, so it works on the instance address immediately and keeps working after you attach your own domain with no configuration edit. Browse to the instance address and sign in to shorten links, choose custom keywords, and review click statistics, traffic sources and country breakdowns. A full REST API and a bookmarklet are included.

Use cases

  • Marketing teams managing campaign links at scale: generate tracked short links per campaign, review country-level click breakdowns, and allocate budget based on engagement data you own.
  • SaaS companies and publishers needing branded domains: run a branded shortener on your own domain so every shared link reinforces your brand while you retain full analytics.
  • Developers integrating programmatic link creation: use the REST API to create, manage and retrieve click stats for short links from your applications, CI/CD pipelines or automation workflows.

Getting started

Launch the AMI, browse to your instance address, retrieve your unique credentials from the root-only file (/root/yourls-credentials.txt), and sign in. For a guided walkthrough or help with custom domain and TLS setup, contact cloudimg support.

cloudimg support

24/7 technical support by email and live chat. Our engineers help with YOURLS deployment and configuration, custom domain and TLS setup, plugin and API configuration, version upgrades, performance tuning, and MariaDB database administration. Critical issues receive a one-hour average response time.

All product and company names are trademarks or registered trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them.

Related technologies

url shortenerlink shortenerbranded short linksclick analyticslink trackingself hosted shortenercustom domain linkslink managementopen source shorteneryourlsmarketing linkscampaign trackingrest api shortener