summary refs log tree commit diff stats
path: root/getwtxt.yml
blob: 34e9cb3b39900bfbe1a093ee01d591f8d7126efa (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
#############################################################
##  This config file can live in the following locations:  ##
##                                                         ##
##      ./                                                 ##
##      /usr/local/getwtxt/                                ##
##      /etc/                                              ##
##      /usr/local/etc/                                    ##
##                                                         ##
##  The first location found wins. The default filename    ##
##  is getwtxt.yml. This can be configured via command     ##
##  line flags:                                            ##
##                                                         ##
##  For "myconfig.json"                                    ##
##    ./getwtxt -config myconfig -type json                ##
##                                                         ##
#############################################################

#############################################################
##  Changing the following options requires a restart.     ##
#############################################################

# Set to true if getwtxt will be behind a reverse
# proxy server, such as Caddy or nginx
BehindProxy: true

# This is the port that getwtxt will bind to.
# If BehindProxy is false, you should probably
# set this to 80 or 443
ListenPort: 9001

# Determines whether we're using SSL/TLS. If so,
# you should set the Cert and Key files.
# Don't use TLS if you're setting up getwtxt
# behind a reverse proxy - just let the proxy
# handle the connection.
UseTLS: false
TLSCert: "/etc/ssl/getwtxt.pem"
TLSKey: "/etc/ssl/private/getwtxt.pem"

#############################################################
##  The following options may be changed at any time.      ##
##  getwtxt will automatically reload the config when      ##
##  changes are detected.                                  ##
#############################################################

# The type of database you want to use. Currently,
# the following are supported:
#   leveldb (default)
#   sqlite
DatabaseType: "leveldb"

# The location of the database structure. Can be
# a relative or absolute path.
DatabasePath: "getwtxt.db"

# The path to the assets directory, which contains:
#     style.css
#     tmpl/index.html
AssetsDirectory: "assets"

# If true, getwtxt will send all log messages, including
# requests, to stdout. It will ignore any set log file.
# Useful for debugging, but you probably want to keep
# logs.
StdoutLogging: false

# Log files getwtxt will use. Requests will be logged
# to RequestLog, while everything else will go into
# MessageLog. These can be relative or absolute paths.
MessageLog: "logs/message.log"
RequestLog: "logs/request.log"

# This is the interval between data pushes from the 
# in-memory cache to the on-disk database. 
DatabasePushInterval: "5m"

# The time getwtxt will wait between attempts to scrape
# users' statuses from their twtxt.txt files
StatusFetchInterval: "1h"

# The following options pertain to your particular instance.
# They are used in the default page shown when you visit
# getwtxt in a web browser.
Instance:

  # The name of your instance.
  SiteName: "getwtxt"

  # Your instance's web address.
  URL: "https://twtxt.example.com"

  # Your name. 
  OwnerName: "Anonymous Microblogger"
  
  # Your email address.
  Email: "nobody@knows"

  # A short description of your instance, or your site.
  # This is shown at the top of the default web page
  # below your instance's name.
  Description: "A fast, resilient twtxt registry server written in Go!"