Skip to content

Template · Other

Shlink

URL shortener with stats, REST API and PostgreSQL.

Deploy on Skiffly

Opens the dashboard with this template pre-selected. Sign in with GitHub if you are new; the free tier needs no card.

  • Postgrespostgres:17
  • Shlinkshlinkio/shlink:stable
Upstream documentation

What gets deployed

2 services in the environment you pick, on the private network of the project.

About this template

shlinkio/shlink:stable + PostgreSQL 17. Create API keys with shlink api-key:generate inside the container.

Postgres

Image: postgres:17

  • Port 5432/tcp
  • 10 GB volume at /var/lib/postgresql/data
  • 1 vCPU · 1 GB

Shlink

Image: shlinkio/shlink:stable

  • Port 8080/http
  • Public domain with TLS
  • 0.5 vCPU · 512 MB
  • /rest/health

Variables

Generated secrets never leave the platform; references are resolved on the private network. Anything marked required is asked for at deploy time.

Postgres

NameValue
POSTGRES_USERpostgresSuperuser name
POSTGRES_PASSWORDgenerated (password)Generated at deploy
POSTGRES_DBshlinkDatabase created on first start
PGDATA/var/lib/postgresql/data/pgdata
DATABASE_URLpostgresql://${{self.POSTGRES_USER}}:${{self.POSTGRES_PASSWORD}}@${{self.SKIFFLY_PRIVATE_DOMAIN}}:5432/${{self.POSTGRES_DB}}Connection string on the private network

Shlink

NameValue
DEFAULT_DOMAIN${{self.SKIFFLY_PUBLIC_DOMAIN}}
IS_HTTPS_ENABLEDtrue
DB_DRIVERpostgres
DB_HOST${{Postgres.SKIFFLY_PRIVATE_DOMAIN}}
DB_PORT5432
DB_NAME${{Postgres.POSTGRES_DB}}
DB_USER${{Postgres.POSTGRES_USER}}
DB_PASSWORD${{Postgres.POSTGRES_PASSWORD}}
INITIAL_API_KEYgenerated (uuid)First API key

Deploy button for your README

Add a one-click deploy link to your repository or docs. Two variants: for light and dark backgrounds.

Deploy on SkifflyDeploy on Skiffly
Markdown · Light background
[![Deploy on Skiffly](https://skiffly.dev/button.svg)](https://skiffly.dev/templates/shlink)
Markdown · Dark background
[![Deploy on Skiffly](https://skiffly.dev/button-dark.svg)](https://skiffly.dev/templates/shlink)
HTML
<a href="https://skiffly.dev/templates/shlink"><img src="https://skiffly.dev/button.svg" alt="Deploy on Skiffly" height="32"></a>

Deploy Shlink in one click

Volumes, secrets and domain pre-wired. Runs on EU nodes, paid per minute from a prepaid balance.