Cloudshort

A private URL shortener that runs on your own Cloudflare account.

Cloudshort turns long links into short ones on your own domain and counts who clicks them. Redirects run on Cloudflare Workers, and a password-protected dashboard on Cloudflare Pages lets you manage links and see clicks. Your links and click data stay in your account, and the Cloudflare free plan is enough for personal and small team use.

• Fast redirects, served from KV at the Cloudflare location nearest each visitor.
• A dashboard to create, copy, edit, and delete links.
• Click analytics: clicks per day, top countries, and top referrers.
• Your own domains for short links and for the dashboard.

Screenshots

Links	Editing a link
Analytics	Settings

Requirements

Needs	Notes
Cloudflare account	Uses Workers, Pages, D1, and KV. The free plan is enough to start.
A domain on Cloudflare	Optional, for links like s.example.com/launch
Node.js 22+ and pnpm 10	Only on the computer you set up from

Quick start

1. Download the code and install: git clone https://github.com/kaizen-network/cloudshort.git, then cd cloudshort and pnpm install.
2. Log in to Cloudflare: npx wrangler login.
3. Run pnpm run project:setup. It creates the database and storage, and asks for an admin password.
4. Run pnpm run project:deploy.
5. In the Cloudflare dashboard, add your short domain to the cloudshort-redirector Worker and your admin domain to the cloudshort-dashboard Pages project. Then log in and set Short Link Domain in Settings.

Documentation

Read the docs on the web at kaizenmc.id/software/cloudshort, or here on GitHub:

• Overview
• Installation
• Using the dashboard
• Configuration
• Updating
• Admin API
• Troubleshooting
• Changelog

Working on Cloudshort itself? See contributing.

License

MIT. See LICENSE.