Card/PagerLog in →

Help · Self-host

Self-host on
your domain.

Overview

What self-hosting gets you

CardPager handles your card at cardpager.com/yourname. With a Pro plan, you can also serve it from your own domain (e.g. alex.com) — CardPager renders inside a tiny HTML page you deploy yourself. Card content updates live; no need to redeploy.

What you get

  • A single HTML file (<your-handle>-card.html).
  • Pre-filled metadata (title, social preview image).
  • An iframe pointing at cardpager.com/embed/yourname.
  • Auto-updating card content (links, photo, colors).

What you don't get

  • We don't host your domain. SSL, DNS, and uptime are yours.
  • We don't configure your DNS for you.
  • If you deactivate your account, the embed shows an "inactive" notice instead of your card.
  • A banned or deleted account's embed stops serving — visitors get a not-found page.

Deploy

Choose a host

Netlify Drop

easiest
Download

In CardPager Settings → Self-host on your domain, download your <your-handle>-card.html, then rename it to index.html — hosts serve this filename automatically at your domain's root. Reuse the same renamed file for any provider below.

Drop

Go to netlify.com/drop and drag your file in — no signup needed for a live preview. Netlify publishes it instantly at a URL like https://flying-pony-123.netlify.app. If you're not signed in, that URL is password-protected until you claim it (next step).

Connect your domain

Sign up for a free Netlify account to claim the deployment, then Site settings → Domain management → Add custom domain → enter alex.com → follow the DNS instructions Netlify shows you (they provide both A and CNAME options).

Vercel

if you use Vercel
Drop

Sign in at vercel.com/drop (free account) and drag your renamed index.html in.

Deploy

Choose a project name and select Deploy. Vercel publishes instantly at a your-project.vercel.app URL.

Connect your domain

Project settings → Domains → add alex.com → Vercel shows you the exact DNS records to add at your registrar (A or CNAME).

Cloudflare Pages

if your DNS is on Cloudflare
Create project

In the Cloudflare dashboard, go to Workers & Pages → Create application → Get started → Drag and drop your files. Put your renamed index.html inside a folder (or a .zip) — Direct Upload doesn't accept a single loose file — enter a project name, and select Deploy site.

Connect your domain

Project → Custom domains → Set up a custom domain → enter your domain. If your DNS is already on Cloudflare, the CNAME is added automatically.

Troubleshooting

Troubleshooting

  • Blank page after deploy. Open the file locally — if it loads, the issue is at your host (file path or domain propagation). Wait 5-15 minutes for DNS to propagate. If your domain redirects between the root and www. and only one of them is connected to your host, you'll get a blank page until both are set up.
  • Social previews show old name. The <title> and og:image are baked into the file at download time. Re-download from Settings to refresh.
  • Cloudflare rejects my upload. Direct Upload needs a folder or a .zip, not a single file. Put your renamed index.html inside a folder (or zip it) before dragging it in.
  • I changed CardPager but the page didn't update. Card content (links, colors, photo) updates live from CardPager. The file you deployed is just an iframe wrapper — never needs re-deploy for content changes.

Still stuck? Email [email protected].