Getting Started
Inkpage Links is a self-hosted short-link app with visit analytics. It runs on Cloudflare (no VPS required).
1. Get the source
Inkpage Links is derived from the open-source project Sink and is distributed under the AGPL-3.0 license. Use the source repository you were given access to — it is not publicly forked, because this deployment is operated as a private instance.
2. Choose where to deploy
- Cloudflare Workers — the only supported target
Cloudflare builds from your repository and publishes the app.
3. Create Cloudflare resources
In the Cloudflare dashboard, create the services Sink will use. Later you will bind them to the project — binding connects a specific resource to Sink under a designated name.
| Binding name | Cloudflare product | Required? | Description |
|---|---|---|---|
DB | D1 (database) | Yes | Stores your links |
KV | KV (key-value store) | Yes | Speeds up redirects |
ANALYTICS | Analytics Engine | Recommended | Visit stats and logs |
R2 | R2 (object storage) | Optional | Backups and social preview images |
AI | Workers AI | Optional | AI-suggested short codes and titles |
For the full experience, create all five. You can add analytics later — see Analytics and Realtime.
After creating D1 and KV, open each resource’s detail page and copy its ID (you will paste it into deploy settings).
4. Configure and deploy
Follow the Workers guide to connect the fork, add bindings, and set variables.
Set NUXT_SITE_TOKEN yourself
This is the password used by API tools (MCP, scripts, curl) — the dashboard itself signs in with Google. Use a long random string (at least 8 characters, no whitespace) and keep it stable — changing it invalidates API callers.
If you skip it, Sink may invent a random password at build time that can change on the next deploy.
Other settings: configuration reference.
5. First login and first link
- Create an OAuth client in the Google Cloud console (type Web application) with the authorized redirect URI
https://your-domain/api/auth/google/callback - Set
NUXT_SESSION_SECRET,NUXT_GOOGLE_CLIENT_ID,NUXT_GOOGLE_CLIENT_SECRET, andNUXT_SUPER_ADMIN_EMAILS(your Google address) - Open
https://your-domain/dashboard - Sign in with Google
- Open Dashboard → Links once
Why open Links once?
The first open finishes a one-time storage setup. Until then, creating links or backups may fail with “storage not ready” (HTTP 423). New installs only need a quick empty check; older KV-only installs migrate data here — see storage setup / migration.
- Create your first short link
The dashboard supports multiple languages. Docs are available in English and Simplified Chinese.