add hostserv page (#64)
continuous-integration/drone/push Build is passing Details

add hostserv page
fix small format error with channel names in title (since # is a comment char for the yaml section)

Reviewed-on: #64
Co-authored-by: Alexander <>
Co-committed-by: Alexander <>
Alexander 1 week ago committed by Ben Harris
parent 420fd558c6
commit 305d90bccf

@ -1,7 +1,7 @@
title: "#bungame"
author: ~khuxkm
description: the bun game in the #bungame channel
description: "the bun game in the #bungame channel"
published: true
- main

@ -2,7 +2,7 @@
author: ~aewens
published: true
title: "A brief history of #chaos"
description: The background and lore behind the #chaos channel
description: "The background and lore behind the #chaos channel"
- main

@ -0,0 +1,44 @@
author: ~alexlehm
published: true
title: HostServ
description: intro to vHosts
- main
--- supports a HostServ service which allows choosing a hostname to display with your IRC user instead of the actual hostname or IP address from which you are connecting.
This may be used to improve privacy or may provide a nice name or a "team" identifier if multiple users use the same vHost.
A hostname is formatted similar to a FQDN, however there are some limitations and actual FQDNs are usually not used.
A hostname should not be an existing domain/hostname or use an existing TLD, also it should not match any of the Tilde domains.
When you actually own a domain you can use it as hostname.
To request a hostname, send a message to the user HostServ with the command
/msg hostserv request
To get a list of all possible commands you send
/msg hostserv help
A request for a hostname is sent to an actual human moderator so that it will take some time to be checked and you will receive feedback when the hostname is approved but not when it is rejected.
When the hostname is approved it will be activated and you can turn it on and off with
/msg hostserv on
/msg hostserv off
To check if your hostname is working, you can query your own user with
/whois username
/ns info username
If you want your tilde name as hostname, HostServ should not be, instead you can run weechat on the machine and connect to localhost or use a bouncer if your Tilde provides one.