🚀 Your Own Branded Link Shortener

Deploy link redirects on your own domain, subdomain, or folder path. Like having your own bit.ly, but completely branded and under your control.

What Can You Do With This?

Turn any domain, subdomain, or folder into a professional link shortener that redirects to your affiliate offers, products, or content.

Short Branded Domain

go.yourbrand.com/affiliate
go.yourbrand.com/product
go.yourbrand.com/special

Get a short domain and turn it into your personal link shortener

Subdomain Links

links.yoursite.com/product
links.yoursite.com/offer
links.yoursite.com/deal

Use a subdomain of your existing website

Folder Path

yoursite.com/go/affiliate
yoursite.com/recommends/tool
yoursite.com/links/product

Add a redirect folder to any existing website

Use Cases & Benefits

Affiliate Marketers

  • Professional branded links instead of ugly affiliate URLs
  • Update destination anytime without changing your links
  • A/B test multiple offers with weighted distribution
  • Track clicks and conversions by link

Product Creators & Course Sellers

  • Memorable links for your products and courses
  • Redirect to different checkouts for testing
  • Update landing pages without changing marketing materials
  • Run promotions by redirecting to special offers

Content Creators & Influencers

  • Short links perfect for social media bios
  • One link that can redirect to current promotion
  • Track which platforms drive the most clicks
  • Professional appearance builds trust

Digital Agencies

  • Manage links for multiple client campaigns
  • Quick campaign pivots without code changes
  • Split test landing pages for optimization
  • Detailed analytics per campaign

The Power of Branded Links

Studies show branded short links get 39% more clicks than generic shorteners. Your own domain = more trust and better conversions.

Quick Start Guide

⚠️ IMPORTANT: Upload to Empty Location Only

Upload scripts to an EMPTY folder or subdomain. Do NOT upload to a location with existing files - it will overwrite them and break your site! Use a dedicated subfolder like /go/ or /links/, OR a clean subdomain/domain if you're dedicating it entirely to link shortening.

Get Up and Running in 4 Simple Steps

1

Download

Get pre-configured ZIP package

~1 min
2

Upload

Upload files to your domain

~3 min
3

Install

Run automatic installer

~1 min
4

Test

Test your first link

~30 sec
Total time: Less than 6 minutes to have your own branded link shortener live!

Download Scripts

Download a ready-to-deploy ZIP package containing all the files you need to run link redirects on your website.

What's Included in the Package

PHP

index.php

Main redirect handler - processes all link requests and sends visitors to the right destination

PHP

flush.php

Update endpoint - receives notifications when links change and refreshes your local cache

CONFIG

config.php

Configuration file - pre-filled with your user ID and security keys

SETUP

install.php

Installation wizard - detects your server type and creates optimized configuration automatically

TOOLS

check-version.php

Version checker - shows your current script version and checks for updates

DIRS

cache/ and logs/

Empty directories for storing cached redirects and click logs

DOCS

README.md

Complete installation guide and troubleshooting reference

Smart Installation: The install.php wizard automatically detects your server (Apache, LiteSpeed, Nginx, IIS) and creates the appropriate configuration file with optimizations for your specific server type.

How to Download

  1. Navigate to Deploy & Download from your dashboard
  2. Click the Download Scripts (ZIP) button
  3. Extract the ZIP file on your computer
  4. Review the files before uploading
  5. Proceed to installation
Ready to go! The package is completely pre-configured with your user ID and security keys - no manual configuration needed.

Installation Instructions

Step-by-Step Installation

1

Extract ZIP File

Unzip the downloaded package on your computer

2

Upload Files to Your Domain

Upload all files to your chosen location using FTP, SFTP, or your hosting control panel:

⚠️ CRITICAL: Upload to EMPTY Location Only!

Do NOT upload to a folder with existing files (like your site root with WordPress, etc.). The scripts include an index.php that will replace your existing index file and break your site. Always use an empty dedicated location!

✓ Folder Path
yoursite.com/go/

Create new /go/ folder

✓ Subdomain
links.yoursite.com/

Clean subdomain

✓ Short Domain
go.yourdomain.com/

Dedicated domain

Choose whichever option fits your branding and domain setup!

3

Run the Installer

Visit install.php in your browser to complete setup:

https://yoursite.com/go/install.php

The installer will:

  • • Detect your server type (Apache, LiteSpeed, Nginx, IIS)
  • • Create optimized server configuration automatically
  • • Register your site for automatic updates
  • • Test everything and confirm it's working
  • • Delete itself for security
4

Test Your First Link

Visit your default link to verify everything works:

https://yoursite.com/go/default

Should redirect to your configured default destination. Success! 🎉

First time setup? Make sure you've created your default link in the dashboard first, or it will use the system default redirect.

If You Encounter Errors
Optional

Fix Directory Permissions (If Needed)

Most hosting providers set permissions correctly automatically. If you see permission errors, run these commands via SSH:

chmod 755 cache/
chmod 755 logs/

Use 775 if 755 doesn't work on your hosting provider

Installation Complete!

Your branded link shortener is now live! All changes you make in the dashboard will automatically sync to your site within minutes.

Register Your Site

Site registration connects your deployed scripts to Link Controller's automatic update system. Once registered, any changes you make to links in the dashboard will automatically propagate to your site within minutes.

Already Registered?

If you ran install.php during installation, your site is already registered automatically! This section explains the registration process and manual registration for advanced use cases.

Why Register Your Site?

  • Automatic updates: Sites receive link changes within minutes - no manual work
  • Update once, everywhere: Change a link in the dashboard, it updates on all your registered sites
  • Reliable synchronization: Automatic retries if updates fail temporarily
  • Status monitoring: Track flush success/failures in your dashboard

Manual Registration (Optional)

If you skipped install.php or need to register an existing site, follow these steps:

Navigate to Sites from your dashboard
Click "Register New Site" button
Fill in your site details
Save - your site is now registered!
Your config.php already contains the correct flush key - no need to copy/paste anything!

Registration Fields Explained

Site Name

A friendly name for your reference (e.g., "My Main Site", "Blog Network", "Client Site #1")

Site URL

The full URL where your scripts are deployed

https://yoursite.com
https://go.yourbrand.com
https://links.yoursite.com
  • • Include the protocol (https://)
  • • Don't include the /go/ folder or script path
Flush Endpoint

Auto-populated based on your site URL - the path to flush.php

https://yoursite.com/flush.php
https://yoursite.com/go/flush.php
https://links.yoursite.com/flush.php

Customize this if you installed scripts in a subdirectory

Security Note

Your flush key is pre-configured in config.php and authenticates all update requests. Keep this file secure - don't share it publicly or commit it to version control.

Managing Your Sites

Once registered, you can monitor and control all your deployed sites from your dashboard. Here's what you can do:

Site Management Features

Active/Inactive Status

Control whether a site receives automatic updates. Perfect for:

  • Active: Site gets all link updates automatically
  • Inactive: Pause updates temporarily (useful for testing or maintenance)

Manual Test Flush

Click the refresh icon to manually trigger an update for any site. Use this to:

  • • Test that your flush endpoint is working correctly
  • • Force an immediate update without waiting
  • • Troubleshoot connection issues

Script Version Tracking

See which version of the redirect scripts each site is running:

  • Green badge - Up to date with latest version
  • Yellow badge - Outdated, update recommended
  • Gray badge - Unknown (legacy install)

Scripts automatically check for updates. When you see yellow, download the latest package and redeploy.

Last Flush Timestamp

See exactly when each site was last successfully updated (e.g., "2 hours ago", "just now"). Helps you identify sites that haven't synced recently.

Delete Site

Remove a site from your registered list when you no longer need it.

Caution:

If you've used this site URL in your links (for offers or analytics tracking), deleting it may affect those features. Consider marking it inactive instead.

How Automatic Updates Work

When you create, edit, or delete a link in your dashboard, a sophisticated synchronization process ensures all your registered sites receive the changes automatically. Here's what happens behind the scenes:

Link Update Timing

When you update a link:

  • • Updates sync automatically
  • • Automatic refresh triggered after 30 seconds
  • • Sites receive updated links
  • • Local cache refreshes within 5 minutes

Changes typically appear within 5 minutes on all sites.

The 6-Step Update Process

1

You Update a Link

Create, edit, or delete a link in your Link Controller dashboard

2

Configuration Prepared

System prepares your updated link configuration file

3

Upload to Cloud Storage

Changes uploaded to secure cloud storage for global distribution

4

Brief Sync Wait

System waits 30 seconds to ensure upload completes successfully

5

Notify Your Sites

Automatic notifications sent to all registered active sites

6

Sites Update Automatically

Your sites download the latest configuration and refresh their cache

Total time: 30-60 seconds from dashboard update to live on all your sites!

Monitoring Update Status

Check your Sites dashboard to see the flush status for each registered site:

Success

Site successfully updated

Warning

Update attempted with warning

Failed

Update failed - check configuration

Technical Requirements

For automatic updates to work, your hosting environment needs to meet these basic requirements. Most hosting providers meet these out of the box.

Server Requirements

  • PHP 7.0 or higher - Modern PHP version (most hosts have 7.4+)
  • cURL extension - Standard PHP extension for downloading updates (usually enabled)
  • Writable directories - Cache and logs folders need write permissions
  • Outbound HTTPS - Ability to make outbound connections (for downloading updates)
  • POST endpoint access - flush.php must be accessible via POST requests

✓ Compatible Hosting

  • ✓ Most shared hosting (cPanel, Plesk)
  • ✓ VPS and dedicated servers
  • ✓ Cloud hosting (AWS, DigitalOcean, Linode)
  • ✓ WordPress hosting
  • ✓ Managed hosting providers

⚠️ May Need Configuration

  • ⚠️ Hosts with strict firewall rules
  • ⚠️ Hosts blocking outbound HTTPS
  • ⚠️ Servers without cURL extension
  • ⚠️ Highly restricted shared hosting

Contact support if you run into issues

How the Update Endpoint Works

  1. Link Controller sends update notification to your site's flush.php
  2. flush.php validates the security key (prevents unauthorized access)
  3. If valid, downloads latest configuration from cloud storage
  4. Updates local cache with new redirect data
  5. Returns success or failure response
  6. Dashboard shows update status for monitoring

Ready to Deploy Your Branded Link Shortener?

Get started in less than 10 minutes!