❓ Frequently Asked Questions

🌟 General

What is LinkDen?

A self-hosted, open-source link-in-bio platform. Think Linktree, but you own everything and it runs on the edge.

Is LinkDen free?

Yes. MIT licensed, zero cost. Cloudflare's free tier covers Workers, D1, and Pages -- so hosting is free too.

Can I use LinkDen commercially?

Absolutely. The MIT license allows unrestricted commercial use. Remove all branding, use it for clients -- no strings attached.

How is LinkDen different from Linktree?

---

🚀 Deployment

Do I need a Cloudflare account?

Yes. LinkDen runs on Cloudflare Workers + Pages (D1 and R2), so a Cloudflare account is required.

Does LinkDen support multiple users?

No. LinkDen is a single-user platform.

• One instance = One link page.
• Need more? Deploy separate instances.

How does authentication work?

LinkDen uses Better Auth.

• No external services needed.
• First user to /admin/setup becomes the admin.
• Registration locks automatically after that.

How do I reset my password?

Use the "Forgot password?" link at /admin/login.

Note: Requires email (Resend or Cloudflare) to be configured in Settings.

---

✨ Features

What block types are available?

Six types: Link, Header, Embed, Connect, vCard, and Location.

How many themes are there?

7 built-in themes (14 total with dark/light variants).

• Corporate, Hacker, Neon, Furry, and more.
• Custom CSS is also supported.

Can I use my own domain?

Yes. See the custom domain guide.

---

🛠️ Troubleshooting

"Failed to..." errors in Admin Panel

1. Is the server running? Check your terminal.
2. Check NEXT_PUBLIC_SERVER_URL: Should be http://localhost:3000 locally.

CORS errors in browser

Set CORS_ORIGIN to your frontend URL (e.g., http://localhost:3001).

Tip: No trailing slash!

Build fails with type errors

Run bun run check-types. Usually fixed by:

• Adding missing environment variables.
• Running bun install.

---

🔄 Updating LinkDen

1. git pull origin main
2. bun install
3. bun run db:generate && bun run db:push
4. bun run deploy