MarcelCoding / admin-guide

Linux Server Administrator Guide

Admin Guide

You can find this repository here: https://adminguide.pages.dev.

Contribute

Feel free to open issues / pull requests.

Please validate that your changes work as intented!
You can start the mkdocs development server by running:

sudo ./serve.sh
# or
sudo sh ./serve.sh

The http server is then listening on port 8000.

Please review every script from the Internet before executing it!

Contribution Guidelines

• Web Services are exposed to [::1]:8000
• Environment Variables are in an env_file (and not in the docker-compose.yml) with the following format:

  # .servicename.env
  KEY=value

• If possible the service should use either mariadb or postgresql. If it makes sense, other databases (e.g. sqlite) are also quiet fine.
• YAML arrays should be quoted, regardless which data is stored:

  volumes:
    - "/srv/service_name/data:/data"
  ports:
    - "[::1]:8000:1234"