# Shlink

> Short links on your domain, with detailed visit stats.

- Page: https://cgt.octabyte.io/templates/shlink/
- Category: Customers & sales
- Replaces: Bitly and Rebrandly
- Ease of use: Some setup. There's no password; you open the web app, click "Add a server" and enter the Shlink address and the API key Cloudgate generated, once in each browser.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: MIT
- Good for: Branded short links with detailed visit stats and smart redirects
- Official website: https://shlink.io
- Documentation: https://shlink.io/documentation/
- Source code: https://github.com/shlinkio/shlink
- Last updated: 2026-11-16

## What is Shlink?

Shlink is a self-hosted URL shortener: short links on your own domain, with detailed visit stats, smart redirects and a web app to manage them.

Shlink is a free, open-source, self-hosted URL shortener and an alternative to Bitly and Rebrandly: it creates short links on your own domain and records every visit, including when it happened, which site sent it, the browser and device, and the country and city. A separate web app lets you create links, tag them and read their stats.

It suits marketers and small businesses who want branded links and want to know which ones work. A bakery, for example, could print go.yourbakery.com/xmas on its Christmas flyers and post go.yourbakery.com/xmas-ig on Instagram, both leading to the pre-order page, then compare the two in Shlink. Phone visitors can be sent to the bakery's app page and everyone else to the website, from the same link.

Shlink has an API for other tools, and an importer that brings across your Bitly links. The web app also makes a QR code for any link. There are no user accounts: anyone who has the API key can manage every link.

Cloudgate installs Shlink, its web app and its database on a server Cloudgate provides or one you connect, and gives each a secure web address. Point your own short domain at the Shlink address, then open the web app and add your server with the API key. Your links and visit stats stay on your server.

## What you can do with Shlink

- **Pick the ending of each link**: Give a short link a custom ending, such as /spring-sale, or let Shlink make a short random one for you.
- **Use your own domain**: Your short links use your own short domain, such as go.yourshop.com, instead of someone else's.
- **See where visits come from**: Each link shows visits over time, the sites that sent them, browsers, operating systems, and countries and cities.
- **Send people to the right page**: Redirect visitors to different pages by their device, language or location, all from one short link.
- **Group links with tags**: Tag links by campaign or channel, then compare their visits side by side.
- **Limit when a link works**: Give a link a start date, an end date or a maximum number of visits.
- **Bring your Bitly links**: A built-in importer copies your existing Bitly links into Shlink.

## Replaces Bitly and Rebrandly

Shlink does the same job as Bitly and Rebrandly. Here is what changes when you switch.

### What you gain

- No limit on links, visits or short domains, and no monthly fee
- City-level visit stats, redirects by device or language, and an API on every link
- Your visit data stays on your server, with visitor IP addresses anonymised
- Change where a link points even after it's printed

### What is different

- The web app has no user accounts; everyone with the API key has full access
- No link-in-bio pages, campaigns or UTM builder
- Country and city stats need a free MaxMind key
- The Bitly import runs from Shlink's command line, not from the web app

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=shlink

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. Shlink itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up Shlink.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is Shlink free?

Yes, Shlink and its web app are free and open source under the MIT licence, with no paid edition and no limit on links or domains. You pay only for your server.

### Is Shlink a good alternative to Bitly?

Yes, if detailed visit stats and smart redirects matter more to you than Bitly's marketing extras, and you want no monthly limits. Shlink shows visits by city, referrer, browser and device, and can redirect by device or language, but it has no campaigns or link-in-bio pages, and its web app has no user accounts.

### How do I sign in to Shlink the first time?

There is no username or password. Open the Shlink web app's address, click "Add a server", and enter the Shlink address and the API key (INITIAL_API_KEY on the app's variables page in Cloudgate). The web app remembers this only in that browser, so each person adds it once on each browser they use.

### How do I use my own short domain with Shlink?

Point your own domain, for example go.yourshop.com, at the Shlink address in your domain provider's settings, and every short link uses that domain. Pick a short domain, because it is the part people see and type.

### Can I import my links from Bitly into Shlink?

Yes, Shlink has a built-in Bitly importer that copies your links using a Bitly access token. It runs from Shlink's command line rather than the web app. Your old bit.ly addresses keep pointing at Bitly.

### Why doesn't Shlink show countries and cities?

Country and city stats need a free MaxMind GeoLite licence key, which you can add when you set up Shlink or later. Without it, everything else works, including visit counts, referrers, browsers and devices.

### Does Shlink make QR codes?

Yes, the Shlink web app makes a QR code for any short link, with your choice of colours and logo. Since Shlink 5 the QR code is made in the web app rather than by the Shlink server, and scans count as visits like any other.

### Do I need technical skills to run Shlink?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up Shlink and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for Shlink?

No. When you deploy Shlink, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.
