One-Click Deployment

The easiest way to get started. This defaults to a completely automated setup.

1. Click the Deploy Button

Click the Deploy Button below or visit OpenShort.link

2. Follow the Automated Setup

• You will be guided to authorize Cloudflare Workers.
• The system will automatically fork this repository to your GitHub account.
• It will automatically create the required D1 database (openshortlink-db) and KV namespace (CACHE).
• Database migrations are applied automatically during deployment.
• Enter Secrets: You will be prompted to enter values for:
  • SETUP_TOKEN: Choose based on your security needs:
    • Production (Most Secure): Generate with openssl rand -hex 32
    • Personal Use: Use a strong password (20+ chars, mixed case, numbers, special chars)
    • Testing: Generate UUID with uuidgen or visit uuidgenerator.net
  • CLOUDFLARE_ACCOUNT_ID: Your Cloudflare Account ID.
  • CLOUDFLARE_API_TOKEN: An API Token with "Account Analytics Read" permission.

3. Configure Worker Routes

• After deployment, go to the Cloudflare Dashboard → Workers & Pages → Your Worker → Settings → Triggers.
• Add routes for your custom domain:
  • yourdomain.com/dashboard/*
  • yourdomain.com/go/*
• Note: Ensure these routes do not clash with existing paths on your website.

4. Create Your First User

• Navigate to https://your-worker.workers.dev/dashboard/setup
• Enter your SETUP_TOKEN.
• Fill in username, email, and password.

That's it! Your link shortener is fully deployed and ready.