domainlink/README.md

21 lines
1 KiB
Markdown
Raw Normal View History

2024-04-08 15:15:38 +00:00
# DomainLink
2024-04-08 15:15:25 +00:00
2024-04-08 21:20:42 +00:00
Lightweight tool for handling (sub-)domain to URL redirects instead of having to deal with copy and pasting proxy rules.
#### System Configuration
The package provides a default configuration in `/usr/share/local/domainlink/config.toml`.
Modifying this is not recommended as updates may override any changes, instead make a copy at `/etc/domainlink/config.toml`.
Any changes there will persist updates and supersede the default config. The System Config only contains the settings for listen addresses and ports.
#### User Configuration
DomainLink currently expects redirect files to be placed in any home directory, specifically `/home/{user}/.config/domainlink/config.toml`.
Redirects are configured in an array, below is an example config.
```toml
[[domain_configs]]
domains = ["sub.domain.tld", "sub2.domain.tld"]
2024-04-09 11:32:53 +00:00
target = "https://sub.domain.tld/query"
2024-04-08 21:20:42 +00:00
```
By default, DomainLink does not create any redirect rules, you will have to create these yourself.
Support for `/root/.config/domainlink/redirects` may come in the future.