From 11bc80ddb4c5fabdd199b03f35c8977380a0c618 Mon Sep 17 00:00:00 2001 From: Lia Lenckowski Date: Sun, 20 Aug 2023 20:43:27 +0200 Subject: document options --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index 99a092b..4047bf0 100644 --- a/README.md +++ b/README.md @@ -3,3 +3,15 @@ This project functions as a meta search engine, resolving shortcuts to other sea The server keeps its own list of bangs, initialized with those from duckduckgo. Users are thus able to submit their own bangs on the website, which need to be approved by an administrator before coming into effect for all users. There is a public instance running at [search.metamuffin.org](https://search.metamuffin.org), running on a server in germany. + +## Configuration +Configuration is done through environment variables. The following may be used: +- PORT: port to bind to. Default: 20546 +- BIND\_ADDR: address to bind to. Default: any ipv4/ipv6 interface +- BASE\_URL: url of the deployed website, without trailing slash. Default: "http://localhost:20546" +- ADMIN\_USER: username for logging into the interface for accepting/rejecting bangs. Default: "bleb" +- ADMIN\_PW\_HASH: hash of the passwort used for logging in. Default: "" + +On the password hash: +The default setting makes it impossible to log in, forcing you to set your own. You DON'T NEED TO DO THIS if you don't plan on adding custom bangs. The format is the sha512 hash of the password, converted to base64. +You can generate a password using the following command: `echo -n YOUR_PASSWORD | sha512sum | awk '{print $1}' | xxd -r -p | base64 | tr -d '\n'` -- cgit v1.2.3-70-g09d2