deprecated directory, wip #4

audiobookshelf/ReadMe.md

@@ -1,4 +1,15 @@
 # Audiobookshelf
+**WARNING**: Audiobookshelf takes an extremely long time to be ready for
+connections, with no indication of when it will be ready. You will get
+continuous 502 Bad Gateway errors until it resolves.
+
 Modified from official instructions: https://www.audiobookshelf.org/docs/#docker-compose-install
 
-**WARNING**: If you ever accidentally leave an old version of an Audiobookshelf database where a new version can see it, a restart may cause it to load the old database, and **its default behavior when this occurs is to delete every file it doesn't recognize**. Thankfully, I had backups, but I have to set up all of the metadata around this all over again now.
+During initial setup, you will be asked to create a library. I just call it
+"Books", use `/audiobooks` for the path, and leave everything else at default.
+
+**WARNING**: If you ever accidentally leave an old version of an Audiobookshelf
+database where a new version can see it, a restart may cause it to load the old
+database, and **its default behavior when this occurs is to delete every file it
+doesn't recognize**. Thankfully, I had backups, but I have to set up all of the
+metadata around this all over again now.

audiobookshelf/docker-compose.yml

@@ -1,6 +1,10 @@
 # TODO set volume directories
 # TODO set timezone (TZ)
 
+# WARNING Audiobookshelf takes an extremely long time to be ready for
+#   connections, with no indication of when it will be ready. You will get
+#   continuous 502 Bad Gateway errors until it resolves.
+
 volumes:
   audiobooks:
     driver: local

cosmos-server/ReadMe.md

@@ -1,7 +1,8 @@
 # Cosmos Cloud
-**WARNING**: A database is set up by the UI using a volume instead of a bind mount,
+**WARNING**: A database is set up by the UI using a volume instead of a bind
-so this setup is ***not*** self-contained.
+mount, so this setup is ***not*** self-contained.
 
 Host mode networking needs to be explicitly enabled in Docker Desktop on macOS.
 
-Newer docker compose versions will complain about the `version` directive, but it is kept for backwards compatibility.
+Newer docker compose versions will complain about the `version` directive, but
+it is kept for backwards compatibility.

immich/ReadMe.md

@@ -5,7 +5,8 @@ WARNING: Does not work with docker-compose.
 
 1. Edit `docker-compose.yml` to set directories and a database password.
 2. Create directories needed: library, database, model-cache
-3. Run docker compose, create admin account, change instance settings before uploading!
+3. Run docker compose, create admin account, change instance settings before
+   uploading!
 
 ## Major Version Upgrades / Breaking Changes
 Check the official docs: https://docs.immich.app/install/upgrading/

miniflux/ReadMe.md

@@ -0,0 +1,6 @@
+# Miniflux
+Modified from [official instructions](https://miniflux.app/docs/docker.html).
+
+I commented out the stuff to create the initial user because I'm running this
+behind Cosmos, where I can temporarily quarantine it from the wider internet
+while configuring it.

miniflux/docker-compose.yml

@@ -0,0 +1,37 @@
+# TODO set volume directories
+# TODO change ALL_CAPS environment variables in all locations
+
+volumes:
+  postgres:
+    driver: local
+    driver_opts:
+      type: none
+      o: bind
+      device: /mnt/apple/miniflux/postgres
+
+services:
+  miniflux:
+    image: miniflux/miniflux:latest
+    # ports:
+    #   - "80:8080"
+    depends_on:
+      db:
+        condition: service_healthy
+    environment:
+      - DATABASE_URL=postgres://miniflux:YOUR_PASSWORD@db/miniflux?sslmode=disable
+      - RUN_MIGRATIONS=1
+      # - CREATE_ADMIN=1
+      # - ADMIN_USERNAME=admin
+      # - ADMIN_PASSWORD=test123
+  db:
+    image: postgres:18
+    environment:
+      - POSTGRES_USER=miniflux
+      - POSTGRES_PASSWORD=YOUR_PASSWORD
+      - POSTGRES_DB=miniflux
+    volumes:
+      - postgres:/var/lib/postgresql
+    healthcheck:
+      test: ["CMD", "pg_isready", "-U", "miniflux"]
+      interval: 10s
+      start_period: 30s

nextcloud/ReadMe.md

@@ -0,0 +1,12 @@
+# NextCloud
+I use an all-in-one image, which **is not *the* AIO or all-in-one image**. I
+don't know why there's a project named that which adds a bunch of stuff and is
+not actually all-in-one but it makes things confusing. :D
+
+The only way I could get this working when I first started using Cosmos as a
+reverse proxy was to use the CasaOS compose, so this is modified from that:
+https://azukaar.github.io/cosmos-casaos-store/servapps/Nextcloud/docker-compose.yml
+
+---
+
+Apparently, I should be using the instructions from https://hub.docker.com/_/nextcloud/

nextcloud/docker-compose.yml

@@ -0,0 +1,26 @@
+# TODO set volume directories
+
+volumes:
+  data:
+    driver: local
+    driver_opts:
+      type: none
+      o: bind
+      device: /mnt/apple/nextcloud/data
+
+services:
+  nextcloud:
+    image: nextcloud:27.1.3
+    container_name: nextcloud
+    hostname: nextcloud
+    deploy:
+      resources:
+        reservations:
+          memory: 512M
+    network_mode: bridge
+    # ports:
+    #   - 10081:80/tcp
+    #   - 10443:443/tcp
+    restart: unless-stopped
+    volumes:
+      - data:/var/www/html

peertube/ReadMe.md

@@ -5,6 +5,7 @@ Modified from official instructions: https://docs.joinpeertube.org/install/docke
 2. Generate `PEERTUBE_SECRET` using `openssl rand -hex 32`.
 3. Create the volume directories needed: config, data, opendkim, postgres, redis
 4. Launch from CLI docker compose.
-5. Search logs for "User password" (near the end) to find the generated password for the root account.
+5. Search logs for "User password" (near the end) to find the generated password
+   for the root account.
 
 Be careful setting up the instance initially. It's not as easy as it seems.

vikunja/ReadMe.md

@@ -1,5 +1,7 @@
 # Vikunja
-**WARNING**: This software is brand new and cannot handle a power failure. I'm probably going to stop using it because of that. I don't want to have to manually recover everything any time there is an uncontrollable issue like this.
+**WARNING**: After a power failure, permissions were reset on the volume this
+app was using, causing it to fail. I have no idea how that occurred. Permissions
+must be user/group 1000 for this to function.
 
 1. [What to backup](https://vikunja.io/docs/what-to-backup/)
 2. [Configuration options](https://vikunja.io/docs/config-options/)

wordpress/ReadMe.md

@@ -0,0 +1,13 @@
+# Wordpress
+This instance has a long history, as I've migrated my blog several times. As a
+result of previously not keeping records, I've lost some of the history of how
+it got here.
+
+Ultimately, I had to modify the docker-compose I'd made for Pressbooks to make
+this work (originally [from here](https://github.com/TangentFoxy/pressbooks-compatible-wordpress-dockerfile/blob/main/docker-compose.yml)).
+
+I briefly tried [the version from awesome-docker-compose](https://github.com/docker/awesome-compose/blob/master/wordpress-mysql/compose.yaml),
+but it doesn't support the ability to make basic edits to a Wordpress install,
+yikes!
+
+(It also used a bad method for setting the database root password. D:)

wordpress/docker-compose.yml

@@ -0,0 +1,42 @@
+# TODO set volume directories
+# TODO change ALL_CAPS environment variables in all locations
+
+volumes:
+  html:
+    driver: local
+    driver_opts:
+      type: none
+      o: bind
+      device: /mnt/apple/blog/html
+  mysql:
+    driver: local
+    driver_opts:
+      type: none
+      o: bind
+      device: /mnt/apple/blog/mysql
+
+services:
+  wordpress:
+    image: wordpress:latest
+    restart: always
+    # ports:
+    #   - 8080:80
+    environment:
+      WORDPRESS_DB_HOST: db
+      WORDPRESS_DB_USER: wordpress
+      WORDPRESS_DB_PASSWORD: YOUR_PASSWORD
+      WORDPRESS_DB_NAME: wordpress
+    volumes:
+      - html:/var/www/html
+
+  db:
+    container_name: db
+    image: mysql:8.0
+    restart: always
+    environment:
+      MYSQL_DATABASE: wordpress
+      MYSQL_USER: wordpress
+      MYSQL_PASSWORD: YOUR_PASSWORD
+      MYSQL_RANDOM_ROOT_PASSWORD: '1'
+    volumes:
+      - mysql:/var/lib/mysql