Your web links, as picture tiles, on your own server.
Paste a link and it becomes a card with a picture. Sort your cards into coloured groups, open them from any device, and keep them private, for everyone in your home.
Quick start · Website · Guide · FAQ
- Links you can see. Every link gets the picture and title its site publishes, so you find things at a glance instead of reading a list of names.
- Organised your way. Coloured groups in your own order, favourites on top, notes on cards, and two layouts to choose from.
- Everywhere you are. One page in any browser, on any device. Save from a browser button, your phone's Share menu, or a script.
- Yours, and private. Runs on your own server with one container and one data folder. No cloud service, no tracking. Each person in your home gets their own private links, and backups are encrypted with your login password.
- Tidy by itself. Duplicates are recognised, tracking junk is stripped from addresses, and a weekly check finds links that stopped working.
- At home in Home Assistant. Install it as an app with its own sidebar page, and get sensors and notifications through MQTT.
|
Saving and organising
|
Bringing links in and out
|
|
Safe and private
|
Pleasant to use
|
services:
tilemark:
image: ghcr.io/sevagjb/tilemark:latest
container_name: tilemark
restart: unless-stopped
ports:
- "8080:8080"
volumes:
- ./data:/data- Paste this into a new stack in Dockge, or save it as
compose.yamland rundocker compose up -d. - Open
http://<your-server>:8080. - Create the first account. The setup code it asks for is in the container log (
docker logs tilemark).
Full walkthrough: Getting started.
Add the repository, install TileMark, turn on Show in sidebar and start it. You're signed in with your Home Assistant account. More: Home Assistant app.
![]() Sections layout, in dark mode |
![]() Import review: duplicates are listed, never lost |
![]() Settings: one card per topic, with its status |
![]() Four languages, including Arabic right to left |
| Getting started | Install, first account, first links, updating, HTTPS |
| Home Assistant app | Sidebar, accounts, own address, backups |
| Links and groups | Everything on the main page |
| Import and export | Bookmarks in, files out, duplicates |
| Save from anywhere | Browser button, phone, API key |
| Broken links | The weekly check |
| Accounts and security | People, two-factor sign-in, devices, passwords |
| Backups | Your own, daily, restoring |
| Home Assistant sensors | Sensors and notifications over MQTT |
| Settings | Every option, card by card |
| Questions and troubleshooting | Common questions and fixes |
| Translating TileMark | Add a language or improve one |
The same guide, as a website: https://sevagjb.github.io/TileMark/
What's coming next is in the roadmap; what changed in each version is in the changelog. Ideas and bug reports are welcome in the issues.
TileMark is a single Flask file (app.py) with a few static pages in pages/, and SQLite for storage.
pip install -r requirements.txt
DATA_DIR=./data python app.py # http://localhost:8080
pip install pytest pyyaml "amqtt==0.12.*" && pytest -qTranslations are in pages/lang/, one file per language; see Translating TileMark.
The website is built from docs/ with python scripts/build_site.py (output in _site/).





