kutt

kutt

Official

Docker app from c4artz' Repository

Overview

Kutt is a modern URL shortener with support for custom domains. Shorten URLs, manage your links and view the click rate statistics.

[b]This container requires Redis a Postgres database and a functioning FQDN![b]

Setup:

  1. Install the Postgres container from your Apps tab.
  2. Create a database an user.
  3. Give the user permissions on the created database.
  4. Install the Redis container from your Apps tab.
  5. Setup an email account which Kutt can use. (technically optional but highly recommended!)
  6. Setup an your preferred method of exposing Kutt to the outside world.
  7. Fill out this template.

Optional:

  1. Setup Google Safe Browsing
  2. Setup Google Analytics

Runtime arguments

Web UI
http://[IP]:[PORT:3000]
Network
bridge
Privileged
false

Template configuration

WebUI PortPorttcp

Container Port: 3000

Target
3000
Default
8080
Database hostVariable

IP of your Postgres instance

Target
DB_HOST
Database portVariable

Port of your postgres instance

Target
DB_PORT
Default
5432
Database nameVariable

Name of your database. Make sure the database is already created and your user has the needed permissions!

Target
DB_NAME
Default
kutt
Database userVariable

Name of your database user

Target
DB_USER
Default
kutt
Database passwordVariable

Password of your database user

Target
DB_PASSWORD
Database SSLVariable

Use SSL for database connection

Target
DB_SSL
Default
false
Redis hostVariable

IP of your Redis instance

Target
REDIS_HOST
RedisVariable

Port of your Redis instance

Target
REDIS_PORT
Default
6379
Redis passwordVariable

Password for your Redis instance. Leave blank if you didn't set one!

Target
REDIS_PASSWORD
Mail hostVariable

Hostname (FQDN or IP) of your mail provider. Used to send verification emails

Target
MAIL_HOST
Mail portVariable

Port of your mail provider. 25 (unencrypted), 587 (TLS), 465 (SMTPS)

Target
MAIL_PORT
Mail secureVariable

Set to true if using port 465

Target
MAIL_SECURE
Default
false
Mail userVariable

Your email username. Most likely your email address

Target
MAIL_USER
Mail passwordVariable

Password of your email user

Target
MAIL_PASSWORD
Mail fromVariable

Sender address

Target
MAIL_FROM
Admin emailsVariable

Comma seperated list of admin email adresses

Target
ADMIN_EMAILS
Report emailVariable

The email address that will receive submitted reports

Target
REPORT_EMAIL
Contact emailVariable

Support email to show on the app

Target
CONTACT_EMAIL
DomainVariable

The domain that this website is on

Target
DEFAULT_DOMAIN
Site nameVariable

The name of the site where Kutt is hosted

Target
SITE_NAME
Default
Kutt
Link lengthVariable

Generated link length

Target
LINK_LENGTH
Default
6
Disable registrationVariable

Disable registration

Target
DISALLOW_REGISTRATION
Default
false
Disable anonymous link creationVariable

Disable anonymous link creation

Target
DISALLOW_ANONYMOUS_LINKS
Default
false
Daily link limitVariable

Default limit for how many links a user can create per day

Target
USER_LIMIT_PER_DAY
Default
50
Anonymous links cooldownVariable

Number of links anonymous users can create per minute. Ignored if anonymous link creation is disabled

Target
NON_USER_COOLDOWN
Default
0
Max number of stats per linkVariable

Max number of visits for each link to have detailed stats

Target
DEFAULT_MAX_STATS_PER_LINK
Default
5000
JSON Web Token keyVariable

A passphrase to encrypt JWT. Use a long and secure key.

Target
JWT_SECRET
Default
securekey
reCaptcha site keyVariable

Invisible reCaptcha key. Create one here https://www.google.com/recaptcha/intro/

Target
RECAPTCHA_SITE_KEY
reCaptcha secret keyVariable

Container Variable: RECAPTCHA_SECRET_KEY

Target
RECAPTCHA_SECRET_KEY
Google safe browsing keyVariable

Google Cloud API to prevent from users from submitting malware URLs. Get one from https://developers.google.com/safe-browsing/v4/get-started

Target
GOOGLE_SAFE_BROWSING_KEY
Google Analytics keyVariable

your GA key

Target
GOOGLE_ANALYTICS
Google Analytics universal keyVariable

Your universal GA key

Target
GOOGLE_ANALYTICS_UNIVERSAL
Internal portVariable

Internal application port. Do not change this!

Target
PORT
Default
3000

Download Statistics

5,102,210
Total Downloads
52,051
This Month
42,554
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
kutt/kutt
Last Updated2026-05-17
First Seen2021-02-17

Run Kutt on Unraid.

Kutt is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.