chore: add resources found while looking for a local carddev server

.vscode/settings.json

@@ -87,6 +87,7 @@
         "buildkit",
         "burstable",
         "byod",
+        "caldav",
         "celeron",
         "cereda",
         "certmanager",
@@ -226,6 +227,7 @@
         "pulumiverse",
         "pvresize",
         "radeon",
+        "radicale",
         "replicatedctl",
         "rfkill",
         "ripsecrets",

containers/baikal/Makefile

@@ -0,0 +1,15 @@
+#!/usr/bin/env make
+
+firewalld-open: override service_name ?= baikal
+firewalld-open: override service_port ?= 80
+firewalld-open: ${shell which 'firewall-cmd'}
+	@sudo firewall-cmd --permanent --new-service '${service_name}'
+	@sudo firewall-cmd --permanent --service '${service_name}' --set-description \
+		'Painless self-hosted all-in-one software development service similar to GitHub, Bitbucket and GitLab.'
+	@sudo firewall-cmd --permanent --service '${service_name}' --set-short 'Private, fast and reliable DevOps platform'
+	@sudo firewall-cmd --permanent --service '${service_name}' --add-port '${service_port}/tcp'
+	@sudo firewall-cmd --permanent --add-service '${service_name}'
+	@sudo firewall-cmd --reload
+
+composition-go-brrr: ${shell which 'docker-compose'}
+	@docker-compose up -d

containers/baikal/docker-compose.yml

@@ -0,0 +1,20 @@
+---
+
+# sources:
+# - https://github.com/ckulka/baikal-docker/blob/master/examples/docker-compose.yaml
+
+version: '2'
+
+services:
+  baikal:
+    image: ckulka/baikal:nginx
+    restart: unless-stopped
+    ports:
+      - "80:80"
+    volumes:
+      - config:/var/www/baikal/config
+      - data:/var/www/baikal/Specific
+
+volumes:
+  config:
+  data:

examples/baikal.yaml

@@ -0,0 +1,20 @@
+---
+system:
+  configured_version: 0.9.5
+  timezone: Europe/Dublin
+  card_enabled: true
+  cal_enabled: true
+  dav_auth_type: Digest
+  admin_passwordhash: 4b2b…7dcd
+  failed_access_message: 'user %u authentication failure for Baikal'
+  auth_realm: BaikalDAV
+  base_uri: ''
+  invite_from: ''
+database:
+  sqlite_file: /var/www/baikal/Specific/db/db.sqlite
+  mysql: false
+  mysql_host: ''
+  mysql_dbname: ''
+  mysql_username: ''
+  mysql_password: ''
+  encryption_key: 5e71…4ce5

knowledge base/baikal.md

@@ -0,0 +1,56 @@
+# Title
+
+Intro
+
+<!-- Remove this line to uncomment if used
+## Table of contents <!-- omit in toc -->
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+   1. [Sources](#sources)
+
+## TL;DR
+
+<details>
+  <summary>Installation and configuration</summary>
+
+```sh
+docker pull 'ckulka/baikal-docker'
+```
+
+Connect to the server via HTTP(S) after first run for first configuration if none was provided.
+
+</details>
+
+<details>
+  <summary>Usage</summary>
+
+```sh
+docker run --rm -p '80:80' 'ckulka/baikal:nginx'
+```
+
+</details>
+
+## Further readings
+
+- [Website]
+- [Github]
+
+### Sources
+
+- [ckulka/baikal-docker]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+<!-- Files -->
+<!-- Upstream -->
+[github]: https://github.com/sabre-io/Baikal
+[website]: https://sabre.io/baikal/
+
+<!-- Others -->
+[ckulka/baikal-docker]: https://github.com/ckulka/baikal-docker

knowledge base/caldav.md

@@ -0,0 +1,27 @@
+# CalDAV
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [WebDAV]
+- [CardDAV]
+
+Implementations:
+
+- [Radicale](https://radicale.org/)
+- [Baikal](https://github.com/sabre-io/Baikal)
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+[carddav]: carddav.md
+[webdav]: webdav.md
+
+<!-- Files -->
+<!-- Upstream -->
+<!-- Others -->

knowledge base/carddav.md

@@ -0,0 +1,32 @@
+# CardDAV
+
+Address book protocol extensions for [WebDAV] designed to allow users to access and share contact data on a server in
+the form of [vCard]s.
+
+1. [Further readings](#further-readings)
+
+## Further readings
+
+- [WebDAV]
+- [vCard]
+- [CalDAV]
+
+Implementations:
+
+- [Radicale](https://radicale.org/)
+- [Baikal](https://github.com/sabre-io/Baikal)
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+[caldav]: caldav.md
+[vcard]: vcard.md
+[webdav]: webdav.md
+
+<!-- Files -->
+<!-- Upstream -->
+<!-- Others -->

knowledge base/docker.md

@@ -131,6 +131,16 @@ docker network ls
 docker network inspect 'monitoring_default'
 
 
+# Create volumes.
+docker volume create 'volume-name'
+
+# List volumes.
+docker volume list
+
+# Inspect volumes.
+docker volume inspect 'volume-name'
+
+
 # Display a summary of the vulnerabilities in images.
 # If not given any input, it targets the most recently built image.
 docker scout qv
@@ -200,6 +210,10 @@ docker compose down
 ```sh
 # Get the SHAsum of images.
 docker inspect --format='{{index .RepoDigests 0}}' 'node:18-buster'
+
+# Act upon files in volumes.
+sudo ls "$(docker volume inspect --format '{{.Mountpoint}}' 'baikal_config')"
+sudo vim "$(docker volume inspect --format '{{.Mountpoint}}' 'gitea_config')/app.ini"
 ```
 
 </details>
@@ -371,6 +385,7 @@ docker load …
 - [Docker ARG, ENV and .env - a Complete Guide]
 - [Configuring HealthCheck in docker-compose]
 - [Docker Buildx Bake + Gitlab CI Matrix]
+- [How to list the content of a named volume in docker 1.9+?]
 
 <!--
   Reference
@@ -397,3 +412,4 @@ docker load …
 [docker buildx bake + gitlab ci matrix]: https://teymorian.medium.com/docker-buildx-bake-gitlab-ci-matrix-77edb6b9863f
 [getting around docker's host network limitation on mac]: https://medium.com/@lailadahi/getting-around-dockers-host-network-limitation-on-mac-9e4e6bfee44b
 [opencontainers image spec]: https://specs.opencontainers.org/image-spec/
+[how to list the content of a named volume in docker 1.9+?]: https://stackoverflow.com/questions/34803466/how-to-list-the-content-of-a-named-volume-in-docker-1-9

knowledge base/nextcloud.md

@@ -8,6 +8,7 @@ Redis is recommended to prevent file locking problems.
    1. [Official helm chart](#official-helm-chart)
 1. [Snappy](#snappy)
 1. [Further readings](#further-readings)
+   1. [Sources](#sources)
 
 ## Containerized
 
@@ -88,16 +89,28 @@ To configure Nextcloud from `snap`:
 
 ## Further readings
 
+- [Website]
 - The docker version's [README][docker readme]
 - The snap version's [README][snap readme]
 - [How to install and configure Nextcloud on Ubuntu 18.04]
 
+Providers:
+
+- [The Good Cloud](https://thegood.cloud)
+
+### Sources
+
+- [Docker image]
+- [Helm chart]
+- [How to check if Redis is used in NC]
+
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
 <!-- Upstream -->
-[check if redis is used by nextcloud]: https://help.nextcloud.com/t/how-to-check-if-redis-is-used-in-nc/22268/2
+[how to check if redis is used in nc]: https://help.nextcloud.com/t/how-to-check-if-redis-is-used-in-nc/22268/2
 [docker image]: https://hub.docker.com/_/nextcloud/
 [docker readme]: https://github.com/docker-library/docs/blob/master/nextcloud/README.md
 [helm chart]: https://github.com/nextcloud/helm/tree/master/charts/nextcloud

knowledge base/vcard.md

@@ -0,0 +1,54 @@
+# vCard
+
+A.K.A. _Virtual Contact File_ (VCF).<br/>
+File format standard for electronic business cards.
+
+Files can contain:
+
+- Name.
+- Address information.
+- Phone numbers.
+- E-mail addresses.
+- URLs.
+- Logos.
+- Photographs.
+- Audio clips.
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+   1. [Sources](#sources)
+
+## TL;DR
+
+<!-- Uncomment if used
+<details>
+  <summary>Installation and configuration</summary>
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Usage</summary>
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Real world use cases</summary>
+</details>
+-->
+
+## Further readings
+
+### Sources
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+<!-- Files -->
+<!-- Upstream -->
+<!-- Others -->

knowledge base/webdav.md

@@ -0,0 +1,46 @@
+# WebDAV
+
+1. [TL;DR](#tldr)
+1. [Further readings](#further-readings)
+   1. [Sources](#sources)
+
+## TL;DR
+
+<!-- Uncomment if used
+<details>
+  <summary>Installation and configuration</summary>
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Usage</summary>
+</details>
+-->
+
+<!-- Uncomment if used
+<details>
+  <summary>Real world use cases</summary>
+</details>
+-->
+
+## Further readings
+
+### Sources
+
+- [CalDAV]
+- [CardDAV]
+
+<!--
+  Reference
+  ═╬═Time══
+  -->
+
+<!-- In-article sections -->
+<!-- Knowledge base -->
+[caldav]: caldav.md
+[carddav]: carddav.md
+
+<!-- Files -->
+<!-- Upstream -->
+<!-- Others -->