How to download, install, configure and use your shortener, step by step and section by section.
Linsei is a self-hosted URL shortener: you install it on your server and, from a panel, create short links, customize them and measure every click. Your data never leaves your hosting.
It is lightweight (PHP with MySQL or SQLite) and grows with you: multiple users with roles, statistics, languages, API and add-ons.
mod_rewrite) or Nginx.index.php and the app/, assets/, plugins/ and data/ folders.No console, no commands:
public_html).config.php and the tables by itself.config.php to read-only and use HTTPS.Go to https://tudominio.com/admin with your username and password. You manage everything from there; to leave, use Log out.
On entering you see a summary: total links, clicks, today's clicks and active links, with a chart of recent days. The «+ New link» button creates one in seconds. The sidebar takes you to the rest.
Click «+ New link» and fill in:
yourdomain.com/promo).blog-my-link).On saving, copy the short link. The list shows the creation date and lets you sort by column (target, clicks, date, status), search and select several for bulk actions: export, activate, deactivate or delete. You can also edit, copy or delete each link.
Ideal for temporary promotions or single-use links.
Each link has its statistics page, with everything you need:
The admin sees everything; each manager, their own, with a ranking of their most-visited links.
As an admin, under Managers you create accounts (with their email) and enable or disable them. If a manager forgets their password, they can recover it by email or the admin can change it on the spot. Two roles:
| Role | What it can do |
|---|---|
| Administrator | Full control: all links and stats, users, settings and updates. |
| Manager | Only their own links and stats. |
Each manager works in isolation: several teams share one install without clashing.
Actions on a manager:
From the list or the statistics you can export to CSV (Excel and Google Sheets) for reports or backups, with filters by date and manager.
The panel is in 8 languages: Spanish, English, French, Portuguese, German, Italian, Dutch and Polish. Switch with the header selector; your choice is remembered. From Settings → Languages you enable/disable languages and upload a new one (a translated .php). You can also drop it by FTP in data/lang/ (safe from updates).
Create links from other programs. Each user has their token (in their profile). Example:
curl -X POST https://tudominio.com/api/links \
-H "Authorization: Bearer TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"url":"https://ejemplo.com/pagina-larga","slug":"promo"}'The response includes the short link.
Linsei extends with add-ons without touching the core. Three ways to install them:
.zip.plugins/ by FTP.Want to build your own? They hook in with hooks (actions and filters). There's a full guide with an example.
bcrypt and native sessions.Always use HTTPS and keep config.php read-only.
Linsei updates in one click. In Settings → Update Linsei you see your installed version and, if there's a new one, an «Update to the latest version» button. Linsei downloads the core, makes a backup and replaces only the program files.
config.php: your links, stats and settings are kept, and if anything fails it restores the backup automatically.You can also update by hand by re-uploading the package files (without deleting config.php or data/), but with the button there's no need.
Inside the panel there is a Help page (/admin/ayuda). Questions or bugs? Write to us from contact.