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
# Address/interface the webhook listener should bind to (default is 127.0.0.1).
bind_address: 127.0.0.1
# Port the webhook listener should bind to (default is 3000).
bind_port: 3000
# Matrix user to sign in as.
user_id: "@mybebot:example.com"
# Password for Matrix user.
password: "secret-matrix-account-password"
# Optional path to an image file to use as the bot account's avatar.
avatar_image_path: "/path/to/avatar.jpg"
# All Gitlab-specific settings are under here.
gitlab_webhook:
# Optional prefix to serve the webhook path under (default is empty string).
url_prefix: "/bebot"
# Default Matrix room to publish Gitlab events to.
default_room: "#my-project-commits:example.com"
# Default set of events to publish. If left out, all events will be published.
default_publish_events:
- name: push
# Regexes of branch names. Leave out entirely for "all branches".
branches:
- '^main$'
- '^xfce-.+'
- name: tag_push
- name: issues
# See the Gitlab docs for a full list of actions. If left out, all actions
# will be published.
actions:
- open
- close
- name: merge_request
# See the Gitlab docs for a full list of actions. If left out, all actions
# will be published.
actions:
- open
- merge
- name: pipeline
# See the Gitlab docs for a full list of statuses. If left out, all
# actions will be published.
statuses:
- failed
# Key-value configuration for repositories.
repo_configs:
# Keys are the instance name / namespace / repository name
"gitlab.example.com/myorg/my-cool-app":
# Each repository should use a unique, randomly-generated token. Enter
# this token in the webhook configuration's "Secret token" on Gitlab.
token: "abcdefg12345"
# You can override the default_room above. Leave out to use the default.
room: "#my-cool-app-events:example.com"
# You can override default_events above. Leave out this section to
# use the defaults.
publish_events:
- name: push
branches:
- main
- name: pipeline
statuses:
- failed
"gitlab.example.com/myuser/some-other-less-cool-app":
token: "kljaslkdjaklsdjalksd"
# This repo uses the default events and room.
# The mail_archive configuration section allows you to set up bebot to publish
# messages based on RSS feeds from mail-archive.com.
mail_archive:
# List of rooms that will be published to by default, unless overridden by
# a per-list config.
default_rooms:
- "#some-room:example.com"
- "#some-other-room:example.com"
# How often bebot will fetch the RSS feed to check for updates, in seconds.
update_interval: 60
# A directory where bebot can store state, such as the data of the last
# entry in the RSS feed it has seen.
state_dir: "/var/lib/bebot/mail-archive-state"
# A list of mailing lists.
lists:
# This is the list name as is displayed in mail-archive.com URLS.
- name: "my-list@example.com"
# Disable publishing a matrix message for replies sent to the list
# (default true). This isn't perfect, and can only guess if a message
# is a reply based on the subject line.
publish_on_replies: false
# An optional list of rooms to publish to. If not specified, the
# default_rooms setting above will be used.
rooms:
- "#yet-some-other-room:example.com"