You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.
 
Peery 5d18c804c5 Implemented error suggestions
If no known command is given. It replies with a list of most likely commands.
7 years ago
projects rename services to lubiland 7 years ago
.gitignore initial config support 7 years ago
LICENSE.md add license file 7 years ago
README.md Added short bot credentials setup guide 7 years ago
commands.js Fixed export of methods in commands.js 7 years ago
config.sample.yaml create matrix config subsection 7 years ago
index.js Implemented error suggestions 7 years ago
package.json initial ssh support - closes #5 7 years ago
rebuild.sh add placeholder notice to rebuild.sh 7 years ago
remoteExec.js make config global with global.config 7 years ago

README.md

Heimdall

Description

Heimdall is a matrix bot supposed to control and manage services and containers by simple text commands. It is a convenience tool for the own self-hosting empire.

Setup the bot credentials

  1. Create or get access to a matrix account to use as the bot.
  2. Acquire the access token and user id. You can do this in riot by going into the settings and scrolling down to the very end.
  3. Copy config.sample.yaml and name the copy config.yaml.
  4. Replace the placeholder values with your own:
    • Replace the baseurl value with the base url of your home server (e.g. https://example.org).
    • Replace the access token with your own.
    • Replace the user id with your own.