diff options
| author | AKP <tom@tdpain.net> | 2022-04-06 11:24:45 +0100 |
|---|---|---|
| committer | AKP <tom@tdpain.net> | 2022-04-06 11:24:45 +0100 |
| commit | 414313360586e444a221de39590455a2407f4f96 (patch) | |
| tree | f2e7cebc057ee74b9935c14a1dd6c245008aae37 /README.md | |
| parent | b18cc60c7f821f465a8f2a865b59015a8e394bba (diff) | |
Add README.md content
Signed-off-by: AKP <tom@tdpain.net>
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 51 |
1 files changed, 51 insertions, 0 deletions
@@ -1,3 +1,54 @@ # walrss *Email-based RSS digest generator* + +--- + + + + + +## Quickstart: Docker + +```bash +docker pull ghcr.io/codemicro/walrss:latest +docker run -d -v $(pwd)/walrss-data:/run -p 8080:8080 ghcr.io/codemicro/walrss:latest +``` + +## Quickstart: Build from source + +You must have an up-to-date version of the Go toolchain installed. Check `go.mod` for the minimum required version. + +```bash +git clone https://github.com/codemicro/walrss.git; cd walrss +go build github.com/codemicro/walrss/walrss +``` + +```bash +mkdir walrss-data +WALRSS_DIR="./walrss-data" ./walrss +``` + +## Config + +Your `config.yaml` file lives in your data directory, which is specified by the `WALRSS_DIR` environment variable (default is `./`). + +```yaml +server: + host: 127.0.0.1 + port: 8080 + # externalURL is the URL that your instance of Walrss is accessible at + # This is a required field + externalURL: "http://127.0.0.1:8080" +email: + # Defaults are not provided for any email option + # All of the below are required fields + password: "yourapikey" + username: "apikey" + host: "smtp.sendgrid.net" + port: 587 + from: "Walrss <walrss@yourdomain.com>" +platform: + disableRegistration: false + disableSecureCookies: false +``` |
