Link previews and safety checks
By default, the server blocks domains on the CERT Polska warning list. You can enable page previews separately.
Link previews
A preview shows the page title, description and image below a message containing a link. Only the server fetches the page. The apps do not connect to linked sites.
Enable previews at both the server and workspace levels.
1. Server. Edit /etc/gadka/gadka.yaml.
link_previews:
enabled: trueRestart the server with sudo systemctl restart gadka.
2. Workspace. An owner or administrator opens Admin, selects Link previews and chooses one of the following settings.
- Enabled for all links
- Selected domains only (one per line, including their subdomains)
- Disabled
Previews stay off in the workspace until someone saves the policy.
| Key | Default | Purpose |
|---|---|---|
link_previews.enabled | false | Enables previews for the installation |
link_previews.proxy | Empty | Optional outbound proxy, such as http://proxy.example.com:3128 |
link_previews.timeout | 3s | Fetch timeout |
link_previews.max_page_bytes | 524288 | Maximum page size |
link_previews.max_image_bytes | 1048576 | Maximum image size |
Previews appear for messages sent or edited after previews are enabled, with up to 3 link previews per message.
Link safety
Whenever someone clicks a link in a message, the server checks it against the CERT Polska warning list. Gadka blocks listed domains and all their subdomains. The user sees Link blocked.
| Key | Default | Purpose |
|---|---|---|
link_safety.enabled | true | Set to false to disable checks |
link_safety.source | https://hole.cert.pl/domains/v2/domains.txt | URL of the list, which contains one domain per line |
link_safety.interval | 5m | How often the server fetches the list (from 1m to 6h) |
link_safety.timeout | 30s | Fetch timeout |
link_safety.max_bytes | 16777216 | Maximum list size |
link_safety.proxy | Empty | Optional outbound proxy |
Owners and administrators can see the list status on the Link previews page, for example CERT Polska Warning List: up to date.
Servers without internet access
- Set
link_safety.sourceto an internal copy ofdomains.txtthat you refresh from a network with internet access. - Set
link_safety.enabled: false.
If the server has been unable to refresh the list for 24 hours, links open without a safety check. The server logs link safety: list update failed.