tiyn/wiki
1
0
Fork 0
mirror of https://github.com/tiyn/wiki.git synced 2025-10-10 01:41:23 +02:00
Code Issues Projects Releases Wiki Activity

restructuring

Browse Source
This commit is contained in:
TiynGER
2020-05-06 18:22:37 +02:00
parent ecb4cde26f
commit ec1dce0518
84 changed files with 1234 additions and 1006 deletions
Download Patch File Download Diff File Expand all files Collapse all files

60
applications/airsonic.md Normal file
View File

@@ -0,0 +1,60 @@
# Airsonic
## Setup Server
### Docker
The official container and documentation was made by [linuxserver](https://hub.docker.com/r/linuxserver/airsonic).
#### Environment-variables
Set the following variables with the -e tag.
| Name | Usage | Default |
| ---- | -------- | ------- |
| PUID | UserID | |
| PGID | GroupID | |
| TZ | Timezone | |
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | --------------- | ----------------------- |
| airsonic\_config | /config | Configuration files |
| airsonic\_media | /media | Various other media |
| media\_playlists | /playlists | Location for playlists |
| media\_music | /music | Location for music |
| media\_audiobooks | /audiobooks | Location for audiobooks |
| media\_podcasts | /podcasts | location for podcasts |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| 4040 | 4040 | TCP | WebUI |
#### Rebuild
```
#!/bin/sh
docker stop airsonic
docker rm airsonic
docker pull linuxserver/airsonic
docker run --name=airsonic \
--restart unless-stopped \
-p 4040:4040 \
-v airsonic_config:/config \
-v airsonic_media:/media \
-v media_playlists:/playlists \
-v media_music:/music \
-v media_audiobooks:/audiobooks \
-v media_podcasts:/podcasts \
-e PUID=0 \
-e PGID=0 \
-e TZ=Europe/Berlin \
-d linuxserver/airsonic
```

50
applications/bind.md Normal file
View File

@@ -0,0 +1,50 @@
# Bind
## Setup Server
### Docker
The official container and documentation was made by [ventz](https://hub.docker.com/r/ventz/bind).
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | --------------- | ----------------------- |
| bind\_cache | /var/cache/bind | cache for dns |
| bind\_etc | /etc/bind | configuration for dns |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------------- |
| 53 | 53 | TCP | dns protocol port |
| 53 | 53 | UDP | dns protocol port |
#### Additional
There are some special variables to set.
| Flag | Usage |
| ----- | ------------------------------------------------------- |
| --dns | set two of these flags for specific dns forward servers |
#### Rebuild
```
#!/bin/sh
docker stop bind
docker rm bind
docker pull ventz/bind:latest
docker run --name bind \
--restart unless-stopped \
--dns=1.1.1.1 --dns=8.8.8.8 \
-p 53:53/udp \
-p 53:53 \
-v bind_cache:/var/cache/bind \
-v bind_etc:/etc/bind \
-d ventz/bind:latest
```

44
applications/cups.md Normal file
View File

@@ -0,0 +1,44 @@
# Cups
## Setup Server
### Docker
The official container and documentation was made by [olbat](https://hub.docker.com/r/olbat/cupsd).
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | --------------- | ------------------------------- |
| cups | /etc/cups | configuration for printers, etc |
| /var/run/dbus | /var/run/dbus | connection to host dbus |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ------------------ |
| 631 | 631 | TCP | cups server webui |
#### Additional
The default username is `print`, the default password is `print`.
#### Rebuild
```
#!/bin/sh
docker stop cups
docker rm cups
docker pull olbat/cupsd:latest
docker run --name cups \
--restart unless-stopped \
--net=host \
-p 631:631 \
-v /var/run/dbus:/var/run/dbus \
-v cups:/etc/cups/ \
-d olbat/cupsd:latest
```

44
applications/dovecot.md Normal file
View File

@@ -0,0 +1,44 @@
# Dovecot
## Setup Server
### Docker
The official container and documentation was made by [tvial](https://hub.docker.com/r/tvial/docker-mailserver).
It contains dovecot, antispam, antivirus, ssl, etc.
#### Configuration
The configuration is done automatically using scripts by tvial.
First you need to download the essential setup files.
```
curl -o setup.sh https://raw.githubusercontent.com/tomav/docker-mailserver/master/setup.sh; chmod a+x ./setup.sh
curl -o docker-compose.yml https://raw.githubusercontent.com/tomav/docker-mailserver/master/docker-compose.yml.dist
curl -o .env https://raw.githubusercontent.com/tomav/docker-mailserver/master/.env.dist
curl -o env-mailserver https://raw.githubusercontent.com/tomav/docker-mailserver/master/env-mailserver.dist
```
After that you need to edit the `.env` and the `env-mailserver` files to configure the mailserver.
You then need to start the container with the `rebuild.sh` and add email accounts using the following command.
`./setup.sh email add <user@domain> (<password>)`
And finally generate the DCIM keys and rebuild once again.
`./setup.sh config dkim`
Afterwards you're ready to go by once again running the `rebuild.sh` file.
#### Rebuild
```
#!/bin/sh
docker-compose down
docker pull tvial/docker-mailserver:latest
docker-compose up -d
```

35
applications/flask.md Normal file
View File

@@ -0,0 +1,35 @@
# Flask
## Setup Server
### Docker
The original container and documentation are made by [tiynger](https://hub.docker.com/r/tiynger/pythonflask).
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ----------- | --------------- | ------------------------------- |
| app | /flask | directory for flask application |
#### Ports
Set the following volumes with the -p tag.
| Container-Port | Recommed outside port | Protocol | Description |
| -------------- | --------------------- | -------- | ----------- |
| 5000 | 80 | TCP | HTTP port |
#### Rebuild
```
#!/bin/sh
docker stop python-flask
docker rm python-flask
docker pull tiynger/pythonflask:latest
docker run --name python-flask \
--restart unless-stopped \
-p "5000:5000" \
-v python-flask:/flask \
-d tiynger/pythonflask:latest
```

44
applications/foldingathome.md Normal file
View File

@@ -0,0 +1,44 @@
# Folding-at-home
## Setup
### Docker
The official container and documentation was made by [johnktims](https://hub.docker.com/r/johnktims/folding-at-home).
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| 7396 | 7396 | TCP | WebUI |
#### Additional
There are some special variables to set.
| Flag | Usage |
| ------- | -------------------------------------- |
| --user | set your username |
| --power | set the default power to fold at home |
| --team | set your teamid to contribute points |
##### GPU
To add a nvidia gpu add the `nvidia-docker-toolkit` or the recommended software for your gpu.
After that you can set you gpu to fold aswell by adding `--gpus=all`.
#### Rebuild
```
#!/bin/sh
docker stop folding-at-home
docker rm folding-at-home
docker pull johnktims/folding-at-home
docker run --name folding-at-home \
--restart unless-stopped \
-it \
-p 7396:7396 \
-d johnktims/folding-at-home \
--user=default \
--power=full \
--team=000000
```

178
applications/git.md Normal file
View File

@@ -0,0 +1,178 @@
# Git
## Setup Server
### Docker
#### Bare (No webinterface)
The official container and documentation was made by [jkarlos](https://hub.docker.com/r/jkarlos/git-server-docker).
##### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | ----------------- | --------------------------- |
| git-server-repos | /git-server/repos | storage for git repos |
| git-server-keys | /git-server/keys | storage for user ssh keys |
##### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ------------------------------------- |
| 22 | 2222 | TCP | ssh port for accessing the git server |
##### Rebuild
```
#!/bin/sh
docker stop git-server
docker rm git-server
docker pull jkarlos/git-server-docker:latest
docker run --name git-server \
--restart unless-stopped \
-p 2222:22 \
-v git-server_repos:/git-server/repos \
-v git-server_keys:/git-server/keys \
-d jkarlos/git-server-docker
```
#### Gitea (Webinterface)
The official container and documentation was made by [gitea](https://hub.docker.com/gitea/gitea).
This docker-rebuild is made up by a `docker-compose.yml` file.
The services in this files are explained seperately.
##### Gitea
###### Environment-variables
Set the following environment-variables in the `environment:` section of the docker-compose file.
| Name | Usage | Default |
| ------------------- | ------------------------------ | ------- |
| USER\_UID | User userid to run gitea | |
| USER\_GID | User groupid to run gitea | |
| DB\_TYPE | Specify database type | |
| DB\_HOST | Specify database host and port | |
| DB\_NAME | Specify Name of the database | |
| DB\_USER | Username for the database | |
| DB\_PASSWD | Password for the database | |
###### Volumes
Set the following volumes in the `volumes:` section of the docker-compose file.
| Volume-Name | Container mount | Description |
| ---------------- | ---------------------- | ------------------------------ |
| data | /data | storage for data of git server |
| /etc/timezone | /etc/timezone:ro | link timezone |
| /etc/localtime | /etc/localtime | link localtime |
###### Ports
Set the following ports in the `ports:` section.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ---------------------- |
| 3000 | 3000 | TCP | WebUI |
| 22 | 222 | TCP | ssh port of git server |
###### Networks
Set the following networks in the `networks:` section of the docker-compose file.
| Name | Usage |
| ----- | --------------------- |
| gitea | connect db with gitea |
###### Dependencies
Set the following dependencies in the `depends_on:` section of the docker-compose file.
| Name | Usage |
| ----- | --------------------- |
| db | Ensure db is running |
##### MySql
###### Environment-variables
Set the following environment-variables in the `environment:` section of the docker-compose file.
| Name | Usage | Default |
| ------------------- | ----------------------------- | ------- |
| MYSQL\_ROOT\_PASSWORD | set the mysql admin password | |
| MYSQL\_USER | set the mysql username | |
| MYSQL\_PASSWORD | set the mysql user password | |
| MYSQL\_Database | specify mysql database to use | |
###### Volumes
Set the following volumes in the `volumes:` section of the docker-compose file.
| Volume-Name | Container mount | Description |
| ---------------- | ---------------------- | ---------------------------- |
| mysql | /var/lib/mysql | storage for owncloud data |
###### Networks
Set the following networks in the `networks:` section of the docker-compose file.
| Name | Usage |
| ----- | --------------------- |
| gitea | connect db with gitea |
##### Rebuild
```
#!/bin/sh
docker-compose down
docker-compose up -d
```
##### Docker-Compose.yml
```
version: "2"
networks:
gitea:
external: false
services:
server:
image: gitea/gitea:latest
environment:
- USER_UID=1000
- USER_GID=1000
- DB_TYPE=mysql
- DB_HOST=db:3306
- DB_NAME=gitea
- DB_USER=gitea
- DB_PASSWD=gitea
restart: unless-stopped
networks:
- gitea
volumes:
- data:/data
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "3000:3000"
- "222:22"
depends_on:
- db
db:
image: mysql:5.7
restart: unless-stopped
environment:
- MYSQL_ROOT_PASSWORD=gitea
- MYSQL_USER=gitea
- MYSQL_PASSWORD=gitea
- MYSQL_DATABASE=gitea
networks:
- gitea
volumes:
- mysql:/var/lib/mysql
volumes:
data:
driver: local
mysql:
driver: local
```

77
applications/gopher.md Normal file
View File

@@ -0,0 +1,77 @@
# Gopherproxy
## Setup Proxy
### Docker
The official container and documentation was made by [prologic](https://hub.docker.com/r/prologic/gopherproxy).
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ---------------------------------------- |
| 8000 | 8000 | TCP | port to proxy the gopher site as http to |
#### Additional
There are some special variables to set.
| Flag | Usage |
| ---- | ------------------------------------------------------------- |
| -uri | define the gopher site to proxy (just 'domain.tld' is enough) |
#### Rebuild
```
#!/bin/sh
docker stop gopheroverhttp
docker rm gopheroverhttp
docker pull prologic/gopherproxy
docker run --name gopheroverhttp \
--restart unless-stopped \
-p 8000:8000 \
-d prologic/gopherproxy \
-uri 'domain.tld'
```
## Setup Server
### Docker
The official container and documentation was made by [tiynger](https://hub.docker.com/r/tiynger/gopherserver).
#### Environment-variables
Set the following variables with the -e tag.
| Name | Usage | Default |
| ------------- | --------------------------------------------------- | --------- |
| SERVER\_NAME | set this to your IP/Domain (no "gopher://" needed!) | localhost |
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| -------------------- | --------------- | ----------------------------- |
| gopherwebdir | /var/gopher | directory for the gopher page |
#### Ports
Set the following ports with the -p tag.
| Container port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | ---------- | ---------------------------- |
| 70 | 70 | TCP | port for the gopher-protocol |
#### Rebuild
```
#!/bin/sh
docker stop gopherserver
docker rm gopherserver
docker pull tiynger/gopherserver
docker run --name gopherserver \
--restart unless-stopped \
-p 70:70 \
-v gopherserver:/var/gopher \
-e SERVER_NAME='domain.tld' \
-d tiynger/gopherserver
```

43
applications/hastebin.md Normal file
View File

@@ -0,0 +1,43 @@
# Hastebin
## Setup Server
### Docker
The official container and documentation was made by [rlister](https://hub.docker.com/r/rlister/hastebin).
#### Environment-variables
Set the following variables with the -e tag.
| Name | Usage | Default |
| ------------ | ----------------------- | ------- |
| STORAGE_TYPE | Type to store the datas | file |
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | --------------- | -------------------------- |
| hastebin | /app/data | storage directory for data |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| 7777 | 7777 | TCP | WebUI |
#### Rebuild
```
#!/bin/sh
docker stop hastebin
docker rm hastebin
docker pull rlister/hastebin:latest
docker run --name hastebin \
--restart unless-stopped \
-p 7777:7777 \
-v hastebin:/app/data \
-e STORAGE_TYPE=file \
-d rlister/hastebin:latest
```

70
applications/homer.md Normal file
View File

@@ -0,0 +1,70 @@
# Homer
## Setup Server
### Docker
The official container and documentation was made by [b4bz](https://hub.docker.com/r/b4bz/homer).
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ------------------------ | --------------- | ---------------------------------- |
| /current/dir/config.yml | /www/config.yml | configuration file for static page |
| homer | /www/assets | storage for icons, etc |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| 8080 | 8080 | TCP | WebUI |
#### Rebuild
```
#!/bin/sh
docker stop homer
docker rm homer
docker pull b4bz/homer:latest
docker run --name homer \
--restart unless-stopped \
-p 8080:8080 \
-v /root/docker/homer/config.yml:/www/config.yml \
-v homer:/www/assets \
-d b4bz/homer:latest
```
#### Configuration
This is a sample config.yml:
```
title: "tmp"
subtitle: "tmp"
logo: "tmp"
footer: ""
message:
style: ""
title: "tmp"
content: "tmp"
links:
- name: "tmp"
icon: "tmp"
url: "tmp"
target: '_blank'
services:
- name: "tmp"
icon: "tmp"
items:
- name: "tmp"
logo: "tmp"
subtitle: "tmp"
tag: "tmp"
url: "tmp"
target: '_blank'
```

79
applications/jellyfin.md Normal file
View File

@@ -0,0 +1,79 @@
# Jellyfin
## Setup Server
### Docker
The official container and documentation was made by [linuxserver](https://hub.docker.com/linuxserver/jellyfin).
This docker-rebuild is made up by a `docker-compose.yml` file.
#### Environment-variables
Set the following environment-variables in the `environment:` section of the docker-compose file.
| Name | Usage | Default |
| ------------------- | ---------------------------- | ------- |
| PUID | Userid to run the container | |
| PGID | Groupid to run the container | |
| TZ | specify the timezone | |
#### Volumes
Set the following volumes in the `volumes:` section of the docker-compose file.
| Volume-Name | Container mount | Description |
| ---------------- | ---------------------- | ------------------------------------ |
| config | /config | storage for config files of jellyfin |
| media\_movies | /data/movies | storage for movies |
| media\_tvshows | /data/tvshows | storage for tvshows |
| transcode | /transcode | tmp storage to transcode |
Because it is useful to have the possibility to use the `media_movies` and `media_tvshows` in multiple containers,
it is recommended to use them as external volumes (volumes section: `external: true` instead of `driver: local`).
To use the rebuild the volumes have to exist before creating the container (`docker volume create media_movies` and tvshows accordingly).
#### Ports
Set the following ports in the `ports:` section.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| 8096 | 8096 | TCP | WebUI |
#### Rebuild
```
#!/bin/sh
docker-compose down
docker pull linuxserver/jellyfin:latest
docker-compose up -d
```
#### Docker-Compose.yml
```
version: "2"
services:
jellyfin:
image: linuxserver/jellyfin
container_name: jellyfin
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/Berlin
volumes:
- config:/config
- media_movies:/data/movies
- media_tvshows:/data/tvshows
- transcode:/transcode
ports:
- 8096:8096
restart: unless-stopped
volumes:
config:
driver: local
transcode:
driver: local
media_movies:
external: true
media_tvshows:
external: true
```

51
applications/khal.md Normal file
View File

@@ -0,0 +1,51 @@
# Khal
`khal` is a calendar you can use in your terminal.
To sync calendars you'll need `vdirsyncer` aswell.
## Setup
### Arch-Linux
- `pacman -S khal vdirsyncer` - Install needed packages
### Configuration
- To configure vdirsyncer edit a file in `~/.config/vdirsyncer/config`.
```
[general]
status_path = "~/.cache/vdirsyncer/status"
#calendar
[pair private_calendar]
a = "private_calendar_local"
b = "private_calendar_remote"
collections = ["from a", "from b"]
metadata = ["color"]
[storage private_calendar_local]
type = "filesystem"
path = "~/.local/share/pim/calendars/private_calendar"
fileext = ".ics"
[storage private_calendar_remote]
type = "caldav"
url = "https://<url>"
auth = "basic"
username = "<username>"
password = "<password>"
```
- `vdirsyncer discober && vdirsyncer metasync` - After that initialize vdirsyncer.
- `vdirsyncer sync` - Synchronize your data (put it in a crontab to run periodically)
- Edit the `~/.config/khal/config`
- Insert the following lines
```
[calendars]
[[calendars]]
path = ~/.local/share/pim/calendars/*/*
type = discover
```

48
applications/khard.md Normal file
View File

@@ -0,0 +1,48 @@
# Khard
`khard` is a adressbook that runs in your terminal.
To sync the data using CardDAV you'll need `vdirsyncer` aswell.
## Setup
### Arch Linux
- `pacman -S khard vdirsyncer` - Install needed programs
### Configuration
- Edit the `~/.config/vdirsyncer/config`.
- Insert the following lines:
```
[general]
status_path = "~/.cache/vdirsyncer/status"
#contacts
[pair private_contacts]
a = "private_contacts_local"
b = "private_contacts_remote"
collections = ["from a", "from b"]
[storage private_contacts_local]
type = "filesystem"
path = "~/.local/share/pim/contacts"
fileext = ".vcf"
[storage private_contacts_remote]
type = "carddav"
url = "https://<url>"
username = "<username>"
password = "<password>"
auth = "basic"
```
- `vdirsyncer discover && vdirsyncer metasync` - Initialize vdirsyncer
- `vdirsyncer sync` - Synchronize the addressbook (put this into a crontab to update periodically)
- Add and configure a config for khard
- `mkdir ~/.config/khard` - add a directory for the config
- `cp /usr/share/doc/khard/khard.conf.example ~/.config/khard/khard.conf` - Copy the example configuration
- Adjust `khard.conf` to your needs
#### Mutt
It is possible to use your khard-addressbook in mutt.
To see how it works check out the [Mutt](/#application/neomutt.md).

79
applications/mordhau.md Normal file
View File

@@ -0,0 +1,79 @@
# Mordhau
## Setup Server
### Docker
The official container and documentation was made by [tetricz](https://hub.docker.com/r/tetricz/mordhau-server).
#### Environment-variables
Set the following variables with the -e tag.
| Name | Usage | Default |
| ---- | ---------------------------------------------------- | ------- |
| QUERYPORT | port for query mordhau | |
| GAME\_PORT | port for mordhau game | |
| BEACONPORT | port for mordhau beacon | |
| STEAM\_CONNECT | set to tell if you want to connect to steam | |
| STEAMID64 | set the serve owner steamid | |
| UID | users userid to run | |
| GID | users groupid to run | |
| GAME\_MODE | specify mordhau game mode | |
| PLAYER\_COUNT | set a playercount limit | |
| SERVER\_NAME | set a servername | |
| SERVER\_PASSWORD | set a password | |
| ADMIN\_PASSWORD | set an admin password | |
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | -------------------- | ---------------------------------------- |
| mordhau | /serverdata/mordhau | storage for mordhau server relevant data |
| mordhau\_steamcmd | /serverdata/steamcmd | storage for steam related data |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------------- |
| 7777 | 7777 | UDP | mordhau internal |
| 15000 | 15000 | UDP | mordhau internal |
| 27015 | 27015 | UDP | mordhau internal |
#### Start
```
#!/bin/sh
docker pull tetricz/mordhau-server
docker run --name=mordhau \
--restart=unless-stopped \
-p 27015:27015/udp \
-p 7777:7777/udp \
-p 15000:15000/udp \
-v mordhau:/serverdata/mordhau \
-v mordhau_steamcmd:/serverdata/steamcmd \
-e QUERYPORT=27015 \
-e GAME_PORT=7777 \
-e BEACONPORT=15000 \
-e STEAM_CONNECT=True \
-e STEAMID64="tmp" \
-e UID=99 \
-e GID=100 \
-e GAME_MODE=SKM \
-e PLAYER_COUNT="16" \
-e SERVER_NAME="tmp" \
-e SERVER_PASSWORD="tmp" \
-e ADMIN_PASSWORD="tmp" \
tetricz/mordhau-server
```
#### Stop
```
#/bin/sh
docker stop mordhau
docker rm mordhau
```

45
applications/neomutt.md Normal file
View File

@@ -0,0 +1,45 @@
# NeoMutt
Neomutt is a mail program that runs in your terminal.
It can be easily configured using mutt-wizard.
## Setup
### Arch-Linux
- `yay -S neomutt isync msmtp pass` - Install all dependecies
- Install mutt-wizard from [github](https://github.com/LukeSmithxyz/mutt-wizard) (AUR is not up to date)
#### Using mutt-wizard
After installation you're able to use the following commands, that will guide you through configuration.
`mw add` to add mailaccounts
`mw ls` to list existing ones
`mw pass` to revise passwords
`mw delete` to delete accounts
`mw purge` to delete all accounts and settings
`mw cron` toggle a cronjob to sync mail
## Usage
## Khard in NeoMutt
- Edit `~/.config/mutt/muttrc`
- Append the following lines.
```
set query_command= "khard email --parsable --search-in-source-files %s"
bind editor <Tab> complete-query
bind editor ^T complete
macro index,pager A \
"<pipe message>khard add-email<return>" \
"add the sender email address to khard"
```
- You should now be able to tab-complete email-addresses in neomutt
- You can also add new ones by pressing A

31
applications/nginx.md Normal file
View File

@@ -0,0 +1,31 @@
# Nginx
## Setup Server
### Docker
The easiest way to configure and run nginx is [ncdt](https://github.com/nasourso/nginx-certbot-docker-tui) by nasourso.
So the first step is downloading it.
`wget https://raw.githubusercontent.com/nasourso/nginx-certbot-docker-tui/master/src/ncdt.sh`
You can just run the script and it will install all needed dependencies.
After that just go ahead and start the container.
You can then configure reverse proxies by adding websites.
#### Block remote port access
If you configured a reverse proxy to a port chances are you don't want the port to be accessed outside of the proxy.
Especially if you set up a authentication over nginx the open port will avoid the authentication.
This can be changed at the forwarded docker-service by replacing for example `-p 7000:7000` with `-p 172.17.0.1:7000:7000`.
This forces the docker container to only expose the port in the docker bridge network, effectively banning remote access.
#### Rebuild
```
#!/bin/sh
docker-compose down
docker pull nginx:latest
docker pull certbot/certbot:latest
docker-compose up -d
```

39
applications/onedrive.md Normal file
View File

@@ -0,0 +1,39 @@
# Onedrive
## Setup Mirror
### Docker
The official container and documentation was made by [oznu](https://hub.docker.com/r/oznu/onedrive).
#### Environment-variables
Set the following variables with the -e tag.
| Name | Usage | Default |
| ---- | -------- | ------- |
| PUID | UserID | |
| PGID | GroupID | |
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | --------------- | ----------------------------------------------- |
| onedrive\_config | /config | configuration storage for the server connection |
| onedrive\_doc | /documents | storage for downloaded documents |
#### Rebuild
```
#!/bin/sh
docker stop onedrive
docker rm onedrive
docker pull oznu/onedrive:latest
docker run --name onedrive \
--restart unless-stopped \
-v onedrive_config:/config \
-v onedrive_doc:/documents \
-e PUID=$(id -u) \
-e PGID=$(id -g) \
-d oznu/onedrive:latest
```

43
applications/openvpn.md Normal file
View File

@@ -0,0 +1,43 @@
# OpenVPN
## Setup Server
### Docker
The official container and documentation was made by [kylemanna](https://hub.docker.com/r/kylemanna/openvpn).
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | --------------- | ------------------------ |
| ovpn | /etc/openvpn | storage for openvpn data |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ------------ |
| 1194 | 1194 | UDP | openvpn port |
#### Additional
There are some special variables to set.
| Flag | Usage |
| --------- | ---------------------- |
| --cap-add | add linux capabilities |
#### Rebuild
```
#!/bin/sh
docker stop openvpn
docker rm openvpn
docker pull kylemanna/openvpn
docker run --name openvpn \
--restart unless-stopped \
--cap-add=NET_ADMIN \
-p 1194:1194/udp \
-v ovpn:/etc/openvpn \
-d kylemanna/openvpn
```

123
applications/owncloud.md Normal file
View File

@@ -0,0 +1,123 @@
# Owncloud
## Setup Server
### Docker
The official container and documentation was made by [owncloud](https://hub.docker.com/_/owncloud).
This docker-rebuild is made up by a `docker-compose.yml` file.
The services in this files are explained seperately.
#### Owncloud
##### Volumes
Set the following volumes in the `volumes:` section of the docker-compose file.
| Volume-Name | Container mount | Description |
| ---------------- | ---------------------- | ---------------------------- |
| owncloud | /var/www/html | storage for owncloud plugins |
| config | /var/www/html/config | storage for owncloud config |
#### Ports
Set the following ports in the `ports:` section.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| 80 | 80 | TCP | WebUI |
#### Maria DB
##### Environment-variables
Set the following environment-variables in the `environment:` section of the docker-compose file.
| Name | Usage | Default |
| ------------------- | ---------------------------- | ------- |
| MYSQL\_ROOT\_PASSWORD | set the mysql admin password | |
##### Volumes
Set the following volumes in the `volumes:` section of the docker-compose file.
| Volume-Name | Container mount | Description |
| ---------------- | ---------------------- | ---------------------------- |
| mariadb | /var/lib/mysql | storage for owncloud data |
#### Rebuild
```
#!/bin/sh
docker-compose down
docker pull owncloud
docker pull mariadb
docker-compose up -d
```
#### Docker-Compose.yml
```
version: '3.1'
services:
owncloud:
image: owncloud
restart: unless-stopped
ports:
- 80:80
volumes:
- owncloud:/var/www/html
- config:/var/www/html/config
mariadb:
image: mariadb
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: pass
volumes:
- mariadb:/var/lib/mysql
volumes:
owncloud:
driver: local
mariadb:
driver: local
config:
driver: local
```
## Setup Client
### Docker
The original container and documentation are made by [tiynger](https://hub.docker.com/r/tiynger/owncloudclient)
#### Environment-variables
Set the following variables with the -e tag.
| Name | Usage | Default |
| ----------- | --------------------------------------------------- | --------- |
| USER | username of OwnCloud server | admin |
| PASSWORD | password of OwnCloud server | admin |
| URL | url of OwnCloud server (dont forget the http(s)://) | localhost |
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ----------- | --------------- | ----------------------------------- |
| data | /data | directory for the owncloud contents |
#### Rebuild
```
#!/bin/sh
docker stop owncloudcli
docker rm owncloudcli
docker pull tiynger/owncloudclient
docker run --name owncloudcli \
--restart unless-stopped \
-v owncloudcli:/data \
-e USER='user' \
-e PASSWORD='password' \
-e URL='https://subdomain.domain.tld' \
-d tiynger/owncloudclient
```

35
applications/pinedocs.md Normal file
View File

@@ -0,0 +1,35 @@
# Pinedocs
## Setup Server
### Docker
The official container and documentation was made by [xy2z](https://hub.docker.com/r/xy2z/pinedocs).
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | --------------- | ----------------------- |
| pinedocs | /data | storage for pinedocs |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| 80 | 80 | TCP | WebUI |
#### Rebuild
```
#!/bin/sh
docker stop pinedocs
docker rm pinedocs
docker pull xy2z/pinedocs
docker run --name pinedocs \
--restart unless-stopped \
-p 80:80 \
-v pinedocs:/data \
-d xy2z/pinedocs
```

43
applications/plex.md Normal file
View File

@@ -0,0 +1,43 @@
# Plex
## Setup Tunnel
### Docker
The official container and documentation was made by [nasourso](https://hub.docker.com/r/nasourso/pltu).
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | --------------- | --------------------------------------------------- |
| pltu | /cert | storage for openvpn certificate of server with plex |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| 80 | 32400 | TCP | Plex webUI |
#### Additional
There are some special variables to set.
| Flag | Usage |
| ------------ | ------------------------ |
| --privileged | is needed due to openvpn |
#### Rebuild
```
#!/bin/sh
docker stop pltu
docker rm pltu
docker pull nasourso/pltu:latest
docker run --name pltu \
--restart unless-stopped \
--privileged \
-p 32400:80 \
-v pltu:/cert/ \
-d nasourso/pltu:latest
```

74
applications/portainer.md Normal file
View File

@@ -0,0 +1,74 @@
# Portainer
## Setup Server
### Docker
The official container and documentation was made by [portainer](https://hub.docker.com/r/portainer/portainer).
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| -------------------- | -------------------- | ------------------------------------------------- |
| portainer | /data | configuration directory |
| /var/run/docker.sock | /var/run/docker.sock | connection to local docker containers and volumes |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| 9000 | 9000 | TCP | WebUI |
#### Rebuild
```
#!/bin/sh
docker stop portainer
docker rm portainer
docker pull portainer/portainer:latest
docker run --name portainer \
--restart unless-stopped \
-p 9000:9000 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer:/data \
-d portainer/portainer
```
## Setup Agent
### Docker
The official container and documentation was made by [portainer](https://hub.docker.com/r/portainer/agent).
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ----------------------- | ----------------------- | -------------------------------------- |
| /var/run/docker.sock | /var/run/docker.sock | connect your running docker containers |
| /var/lib/docker/volumes | /var/lib/docker/volumes | connect running docker volumes |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | -------------------- |
| 9001 | 9001 | TCP | Portainer agent port |
#### Rebuild
```
#!/bin/sh
docker stop portainer_agent
docker rm portainer_agent
docker pull portainer/agent:latest
docker run --name portainer_agent \
-p 9001:9001 \
--restart unless-stopped \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /var/lib/docker/volumes:/var/lib/docker/volumes \
-d portainer/agent:latest
```

199
applications/radicale.md Normal file
View File

@@ -0,0 +1,199 @@
# Radicale
## Setup Server
### Docker
The official container and documentation was made by [tomsquest](https://hub.docker.com/r/tomsquest/docker-radicale).
The `latest` tag at the moment of writing this readme was corrupted.
The last usable tag was used therefore to guarantee best performance for all users.
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | --------------- | --------------------------- |
| radicale\_data | /data | storage for caldav |
| radicale\_config | /config | storage for radicale config |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ------------- |
| 5232 | 5232 | TCP | WebUI, caldav |
#### Additional
There are some special variables to set.
| Flag | Usage |
| ----------- | ---------------------------------------------------------------------- |
| --read-only | make radicale read-only, caldav can still be changed and used normally |
#### Rebuild
```
#/bin/sh
docker stop radicale
docker rm radicale
docker pull tomsquest/docker-radicale:2.1.11.4
docker run --name radicale \
--restart unless-stopped \
--read-only \
-p 5232:5232 \
-v radicale_data:/data \
-v radicale_config:/config \
-d tomsquest/docker-radicale:2.1.11.4
```
#### Configuration
After installation there are a few crucial steps to take to secure your calendars with a login.
It is important to change the config file which can be found in the docker volume with name `radicale_config` to match the `config`-file.
```
# -*- mode: conf -*-
# vim:ft=cfg
# Config file for Radicale - A simple calendar server
#
# Place it into /etc/radicale/config (global)
# or ~/.config/radicale/config (user)
#
# The current values are the default ones
[server]
# CalDAV server hostnames separated by a comma
# IPv4 syntax: address:port
# IPv6 syntax: [address]:port
# For example: 0.0.0.0:9999, [::]:9999
#hosts = 127.0.0.1:5232
hosts = 0.0.0.0:5232
# Max parallel connections
#max_connections = 8
# Max size of request body (bytes)
#max_content_length = 100000000
# Socket timeout (seconds)
#timeout = 30
# SSL flag, enable HTTPS protocol
#ssl = False
# SSL certificate path
#certificate = /etc/ssl/radicale.cert.pem
# SSL private key
#key = /etc/ssl/radicale.key.pem
# CA certificate for validating clients. This can be used to secure
# TCP traffic between Radicale and a reverse proxy
#certificate_authority =
# SSL Protocol used. See python's ssl module for available values
#protocol = PROTOCOL_TLSv1_2
# Available ciphers. See python's ssl module for available ciphers
#ciphers =
# Reverse DNS to resolve client address in logs
#dns_lookup = True
[encoding]
# Encoding for responding requests
#request = utf-8
# Encoding for storing local collections
#stock = utf-8
[auth]
# Authentication method
# Value: none | htpasswd | remote_user | http_x_remote_user
type = htpasswd
# Htpasswd filename
htpasswd_filename = /data/users
# Htpasswd encryption method
# Value: plain | sha1 | ssha | crypt | bcrypt | md5
# Only bcrypt can be considered secure.
# bcrypt and md5 require the passlib library to be installed.
htpasswd_encryption = bcrypt
# Incorrect authentication delay (seconds)
#delay = 1
# Message displayed in the client when a password is needed
#realm = Radicale - Password Required
[rights]
# Rights backend
# Value: none | authenticated | owner_only | owner_write | from_file
#type = owner_only
# File for rights management from_file
#file = /etc/radicale/rights
[storage]
# Storage backend
# Value: multifilesystem
#type = multifilesystem
# Folder for storing local collections, created if not present
#filesystem_folder = /var/lib/radicale/collections
filesystem_folder = /data/collections
# Delete sync token that are older (seconds)
#max_sync_token_age = 2592000
# Command that is run after changes to storage
# Example: ([ -d .git ] || git init) && git add -A && (git diff --cached --quiet || git commit -m "Changes by "%(user)s)
#hook =
[web]
# Web interface backend
# Value: none | internal | radicale_infcloud
# (See also https://github.com/Unrud/RadicaleInfCloud)
type = internal
[logging]
# Threshold for the logger
# Value: debug | info | warning | error | critical
#level = warning
# Don't include passwords in logs
#mask_passwords = True
[headers]
# Additional HTTP headers
#Access-Control-Allow-Origin = *
```
Following this you need to make sure there is a password file in the docker volume `radicale_data` called `users`.
The password will be encrypted using `bcrypt`.
Steps to create a file with a user and password:
- You will have to install the package which includes `htpasswd`; for debian based distributions this is `apt install apache2-utils`
- `cd /var/lib/docker/volumes/radicale\_data/\_data` - go to the volume
- `touch ./users` - create a file called users
- `htpasswd -B ./users username` - add user with name and password to the file (change `username` to your desired username)
Now you can go to the exposed port and login with your chosen username and password.
If you only added one user you shouldn't be able to login with any other data than your username and password.

61
applications/samba.md Normal file
View File

@@ -0,0 +1,61 @@
# Samba
## Setup Server
### Docker
The official container and documentation was made by [dperson](https://hub.docker.com/r/samba).
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | --------------- | ------------------------------ |
| samba\_nas | /nas | storage for samba data |
| samba\_lib | /var/lib/samba | storage for samba lib |
| samba\_cache | /var/cache/samba | storage for samba cache |
| samba\_run | /run/samba | run entries for samba |
| samba\_etc | /etc | etc directory of samba server |
| samba\_log | /var/log/samba | storage for samba logs |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | -------------- |
| 139 | 139 | TCP | Samba internal |
| 445 | 445 | TCP | Samba internal |
#### Additional
There are some special variables to set.
| Flag | Usage |
| --------------------------------------------------------------------- | ---------------- |
| -u \<username;password\>(;ID;group;GID) | define user |
| -w \<workgroup\> | define workgroup |
| -s \<name;path\>(;browse;readonly;guest;users;admins;writelist;comment) | define shares |
#### Rebuild
```
#!/bin/sh
docker stop samba
docker rm samba
docker pull dperson/samba
docker run --name samba \
--restart unless-stopped \
-p 139:139 \
-p 445:445 \
-v samba_nas:/nas \
-v samba_lib:/var/lib/samba \
-v samba_cache:/var/cache/samba \
-v samba_run:/run/samba \
-v samba_etc:/etc \
-v samba_log:/var/log/samba \
-d dperson/samba -p \
-u "user1;pass1" \
-u "user2;pass2" \
-s "public;/nas/public" \
-s "user1private;/nas/user1;no;no;no;user1;user1" \
-s "user2private;/nas/user2;no;no;no;user2;user2"
```

25
applications/sc-im.md Normal file
View File

@@ -0,0 +1,25 @@
# SC-IM
`sc-im` is a program to view and edit tables especially in csv-format.
## Setup
### Arch-Linux
- `yay -S sc-im` - Install sc-im
- `sc-im <insert-filename>.csv` - Edit files
## Usage
`sc-im` uses vim keys to move.
You can insert text to a cell with `\` and numbers using `=`.
You can edit existing entries with `e` for text and `E` for numbers.
You can delete (multiple (for example `3`) rows `dr`/`d3r`, yank rows `yr`/`y3r`.
You can delete (multiple (for example `3`) columns `dc`/`d3c`, yank rows `yc`/`y3c`.
You can insert new rows `ir`/`i3r` or columns `ic`/`i3c`.
### Special numbers
There are some functions you can use when in numbers mode.
- `=@sum(<start-cell>:<end-cell>)` - Summarize all number-entries in the range of given cells

14
applications/shells.md Normal file
View File

@@ -0,0 +1,14 @@
# Shells
## Change /bin/sh
### Arch-Linux
The Shell in Arch-Linux is made up by a POSIX compliant mode of bash.
Problem with that is the speed.
A shell like dash would be much faster.
This is a guide on how to persistently change the symlink /bin/sh from bash to dash.
- `yay -S dash` - Install dash
- `sudo ln -sfT /bin/dash /bin/sh` - link /bin/sh to dash
- `sudo vim /usr/share/libalpm/hooks/bash-update.hook` - setup a hook to avoid bash resetting the symlink

53
applications/syncthing.md Normal file
View File

@@ -0,0 +1,53 @@
# Syncthing
## Setup
### Docker
The official container and documentation was made by [linuxserver](https://hub.docker.com/r/linuxserver/syncthing).
#### Environment-variables
Set the following variables with the -e tag.
| Name | Usage | Default |
| --------- | ---------------- | ------- |
| PUID | UserID | |
| PGID | GroupID | |
| TZ | Timezone | |
| UMASK\_SET | setting usermask | |
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | --------------- | ----------------------------------------------- |
| syncthing\_config | /config | storage for config and possible downloaded data |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ------------------ |
| 8384 | 8384 | TCP | WebUI |
| 22000 | 22000 | TCP | Syncthing internal |
| 21027 | 21027 | UDP | Syncthing internal |
#### Rebuild
```
#!/bin/sh
docker stop syncthing
docker rm syncthing
docker pull linuxserver/syncthing
docker run --name syncthing \
--restart unless-stopped \
-p 8384:8384 \
-p 22000:22000 \
-p 21027:21027/udp \
-v syncthing_config:/config \
-e PUID=0 \
-e PGID=0 \
-e TZ=Europe/Berlin \
-e UMASK_SET=022 \
-d linuxserver/syncthing
```

47
applications/teamspeak.md Normal file
View File

@@ -0,0 +1,47 @@
# Teamspeak3
## Setup Server
### Docker
The official container and documentation was made by [teamspeak](https://hub.docker.com/_/teamspeak).
#### Environment-variables
Set the following variables with the -e tag.
| Name | Usage | Default |
| ----------------- | ---------------------------- | ------- |
| TS3SERVER\_LICENSE | accept the license agreement | |
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | --------------- | --------------------------- |
| teamspeak3 | /var/ts3server | storage for ts3-server data |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| 9987 | 9987 | UDP | ts3-intern |
| 10011 | 10011 | TCP | ts3-intern |
| 30033 | 30033 | TCP | ts3-intern |
#### Rebuild
```
#!/bin/sh
docker stop teamspeak3
docker rm teamspeak3
docker pull teamspeak:latest
docker run --name teamspeak3 \
--restart unless-stopped \
-p 9987:9987/udp \
-p 10011:10011 \
-p 30033:30033 \
-v teamspeak3:/var/ts3server \
-e TS3SERVER_LICENSE=accept \
-d teamspeak:latest
```

37
applications/todo-list.md Normal file
View File

@@ -0,0 +1,37 @@
# Todo-List
## Setup Server
### Docker
The official container and documentation was made by [prologic](https://hub.docker.com/r/prologic/todo).
#### Volumes
Set the following volumes with the -v tag.
| Volume-Name | Container mount | Description |
| ---------------- | -------------------- | ----------------------- |
| todo | /go/src/todo/todo.db | Database for todo list |
#### Ports
Set the following ports with the -p tag.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| 8000 | 8000 | TCP | WebUI |
#### Rebuild
```
#!/bin/sh
docker stop todo
docker rm todo
docker pull prologic/todo
docker run --name todo \
-p 8000:8000 \
--restart unless-stopped \
-v todo:/go/src/todo/todo.db \
-d prologic/todo
```

23
applications/wine.md Normal file
View File

@@ -0,0 +1,23 @@
# Wine
Wine is a compatibility layer to run windows programs on linux machines.
## Setup
### Arch-Linux
- Enable multilib support in pacman
- `vim /etc/pacman.conf` - Uncomment the following lines
```
[multilib]
Include = /etc/pacman.d/mirrorlist
```
- `pacman -S wine winetricks` - Install wine and configuration helper
### Configuration
- Set the global variable `WINEPREFIX` to your liking, standard is `$HOME/.wine`
- `winetricks` - run the installation of basic windows dependencies to the wine directory
- Move the program you want to run to `$WINEPREFIX/drive_c/`
- `winetricks sandbox` - (Optional) if you don't want wine to set up directories or files into your home directory
- `wine $WINEPREFIX/drive_c/<insert program>` - Run the program with wine