Shorten, track, and manage your links. Create beautiful bio profiles.

A self-hosted link management and bio profile platform — your own Linktree alternative with full analytics, custom domains, admin controls, and a one-command Docker installer.

• URL shortener with custom short codes
• Full short URL displayed on every link card (e.g. https://yoursite.com/s/abc123)
• QR code generation per link
• Click analytics — country, device, browser, referrer
• Landing page builder per link (custom title, body, image, theme)
• Link enable/disable toggle

• Custom /@slug profile pages
• Profile photo + header image (half banner, full banner, or cover)
• Bio description, header text, sub-header text
• Multiple profile themes (May Flowers, Midnight Purple, Ocean Breeze, and more)
• Custom CSS editor for full control
• Social icon links
• Tabbed profile sections with independent link lists
• Daily status message
• Profile password protection
• Age restriction + cookie consent popup
• Profile redirect (send all visitors to a URL)
• Remove branding option

• Per-link charts — clicks/day, top countries, devices, referrers
• Admin stats dashboard — users, clicks, profile views, messages, reports
• Redis-queued click processing (zero redirect slowdown)
• Configurable retention (default 90 days)

• Users add their own domain — DNS A record → server IP
• Admin grants per-user domain access via toggle
• Cloudflare proxy supported — auto-detected via IP range check + HTTP reachability
• "I'm using Cloudflare" self-approve button — users activate without waiting for admin
• Domain-aware short links (/s/CODE resolves per domain owner)
• Root domain redirect + custom 404 redirect per domain
• DNS A record verification button

• JWT access + refresh tokens
• Two-factor authentication (TOTP / authenticator app)
• Password reset via email
• Per-user ban / suspend controls
• NGINX rate limiting — auth (10r/m), API (30r/s burst 50), redirect (60r/s)
• Security headers (X-Frame-Options, X-Content-Type-Options, Referrer-Policy, etc.)

• Contact form on every bio profile
• Guest messages (no account needed)
• Thread replies
• Unread count badge

• User management — roles, ban, suspend, delete
• Domain management — grant/revoke per user, view all domains and status
• Navigation editor — custom nav links
• Page manager — create custom CMS pages
• Email template editor — customise all transactional emails
• SMTP settings (editable via UI, no redeploy needed)
• File upload manager — upload and copy asset URLs
• Reports dashboard — review/dismiss/delete profile reports
• Statistics dashboard — users, clicks, profile views, messages

• Ubuntu / Debian server (Docker auto-installs if missing)
• OR any machine with Docker + docker-compose already installed

bash v11_8_3.sh

That's it. The script:

1. Installs Docker if needed
2. Generates a secure SECRET_KEY
3. Builds and starts all 6 containers
4. Seeds the admin account
5. Prints your login URL

Edit the top of v11_8_3.sh before running:

SITE_NAME="LinkPlatform"
SITE_EMOJI="🔗"
SITE_TAGLINE="Shorten, track, and manage your links."

DEPLOY_DOMAIN=""       # e.g. "mylinks.com" — leave blank for localhost only

ADMIN_EMAIL="admin@admin.admin"
ADMIN_PASSWORD="admin"
DEFAULT_THEME_COLOR="#a78bfa"

⚠️ Change ADMIN_EMAIL and ADMIN_PASSWORD before going live.

Set this to your domain and the installer automatically configures:

The app works on localhost, local IP, and your domain simultaneously from first boot. All API calls use relative paths so there are never cross-origin issues.

Once an admin enables custom domains for your account:

1. Go to Bio Profile → Domain tab
2. Enter your domain (e.g. mylinks.com)
3. At your DNS provider, add an A record:

1. Click 🔍 Verify DNS

If your domain uses Cloudflare's orange-cloud proxy, click 🔶 I'm using Cloudflare instead. This self-approves the domain immediately — no admin needed, no IP matching required. Your links go live as soon as Cloudflare routes traffic to the server.

Browser
  │
  ▼
NGINX :80              ← reverse proxy, rate limiting, security headers
  ├── /api/*           → FastAPI backend :8000
  ├── /s/* /l/*        → FastAPI (short link redirects)
  ├── /@slug           → FastAPI (bio profile pages — server-rendered Jinja2)
  └── /*               → Vite frontend :3000 (React SPA)

FastAPI                ← Python, SQLAlchemy, JWT auth, Jinja2 templates
PostgreSQL             ← primary data store
Redis                  ← click event queue
Click Worker           ← background processor (Redis → PostgreSQL)
Cleanup Worker         ← prunes click data older than retention window

linkplatform start        # Start all 6 services
linkplatform stop         # Stop all services
linkplatform restart      # Restart all services
linkplatform logs         # Tail backend logs
linkplatform logs nginx   # Tail NGINX logs
linkplatform worker       # Tail click worker logs
linkplatform status       # Container status
linkplatform backup       # Backup PostgreSQL database
linkplatform update       # Rebuild with latest code
linkplatform shell        # Backend bash shell
linkplatform db           # psql shell
linkplatform redis        # redis-cli

linkplatform backup
# Saves to ~/link-platform-backups/db_YYYYMMDD_HHMMSS.sql
# Keeps the 10 most recent backups automatically

Re-run the installer — detects existing install, stops containers, overwrites code, restarts. Database and uploads are safe.

bash v11_8_3.sh

Full reset (destroys all data):

cd ~/link-platform && docker-compose down -v
bash v11_8_3.sh

The installer sets up HTTP on port 80. For production HTTPS the easiest path is Cloudflare orange-cloud proxy — point your domain at the server, enable the proxy, SSL is handled automatically.

For self-managed SSL use Caddy or certbot in front of port 80.

~/link-platform/
├── backend/
│   ├── app/
│   │   ├── main.py                # FastAPI app, routes, DB migrations
│   │   ├── models.py              # SQLAlchemy models
│   │   ├── config.py              # Settings (pydantic-settings + .env)
│   │   ├── auth.py                # JWT + password utilities
│   │   ├── routers/
│   │   │   ├── links.py           # Link CRUD
│   │   │   ├── profile.py         # Bio profile
│   │   │   ├── custom_domains.py  # Domain mgmt + CF-aware verification
│   │   │   ├── analytics.py       # Click analytics
│   │   │   ├── admin.py           # Admin endpoints
│   │   │   └── ...
│   │   ├── services/              # Redis client, redirect service
│   │   ├── workers/               # Click processor, cleanup worker
│   │   └── templates/             # Jinja2 HTML (bio profiles, emails)
│   ├── Dockerfile
│   ├── requirements.txt
│   └── .env
├── frontend/
│   ├── src/
│   │   ├── pages/                 # React page components
│   │   ├── components/            # Navbar, LinkCard, Toast…
│   │   ├── context/               # Auth + Theme context providers
│   │   └── styles/                # Global CSS + theme variables
│   ├── vite.config.js             # allowedHosts: true, --force on start
│   └── package.json
├── nginx/
│   └── nginx.conf                 # Rate limits, proxy rules, security headers
├── docker-compose.yml
├── backup.sh
└── linkplatform                   # CLI tool

Change these before going live.

MIT — do whatever you want with it.

Built with FastAPI · React · PostgreSQL · Redis · Docker