From 5c8daeeba0223af82ae981ff9b01041e3d623954 Mon Sep 17 00:00:00 2001
From: SubBass100 <60083876+SubBass100@users.noreply.github.com>
Date: Fri, 17 Jan 2025 07:42:16 -0500
Subject: [PATCH 1/4] Create Local_with_MINIO.MD

---
 Local_with_MINIO.MD | 176 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 176 insertions(+)
 create mode 100644 Local_with_MINIO.MD

diff --git a/Local_with_MINIO.MD b/Local_with_MINIO.MD
new file mode 100644
index 0000000..f06de3a
--- /dev/null
+++ b/Local_with_MINIO.MD
@@ -0,0 +1,176 @@
+```markdown
+# Installing Trunk-Server Locally (no HTTPS)
+
+## Prerequisites:
+
+1. **Set static IP for trunk-server**
+2. **Set DNS for admin account**: Point `api` to the trunk-server IP.
+3. **Install Ubuntu Server 24.04**
+4. **Update system:**
+   ```bash
+   sudo apt update
+   sudo apt upgrade
+   ```
+5. **Add subdomains to `/etc/hosts`:**
+   ```bash
+   127.0.0.1       openmhz.test account.openmhz.test api.openmhz.test admin.openmhz.test media.openmhz.test
+   ```
+6. **Flush DNS cache:**
+   ```bash
+   sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
+   ```
+
+7. **Create a file in your user's home directory for AWS credentials:**
+   ```bash
+   mkdir ~/.aws
+   nano credentials
+   ```
+   Add the following content to the file:
+   ```ini
+   [default]
+   aws_access_key_id = [..]
+   aws_secret_access_key = [..]
+   ```
+
+## Install Docker (from Docker Docs)
+
+1. **Update and install prerequisites:**
+   ```bash
+   sudo apt update
+   sudo apt-get install ca-certificates curl
+   sudo install -m 0755 -d /etc/apt/keyrings
+   ```
+
+2. **Add Docker's official GPG key:**
+   ```bash
+   sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
+   sudo chmod a+r /etc/apt/keyrings/docker.asc
+   ```
+
+3. **Add Docker repository to APT sources:**
+   ```bash
+   echo \
+   "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
+   $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
+   sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+   ```
+
+4. **Update system and install Docker:**
+   ```bash
+   sudo apt update
+   sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
+   ```
+
+## Setting up MINIO (on another machine/VM)
+
+- It is possible to run MinIO on the same machine (though not recommended).
+- Follow the MinIO installation guide for Linux: [MinIO Installation Docs](https://min.io/docs/minio/linux/operations/installation.html)
+- For a small home setup, use **Single-Node Single-Drive (SNSD)** or **Standalone** mode.
+
+### High-Level MinIO Crash Course:
+
+1. **Create a bucket** (this is where you will store audio from TrunkServer).
+2. **Set Access Policy for the bucket to Public** (Reminder: This is for local, NON-Internet only).
+3. **Create an Access Key and Secret**:
+   - Copy the secret as you can only view it once. If lost, create a new key and delete the old one.
+
+## Install Trunk Server
+
+1. **Clone the repository:**
+   ```bash
+   git clone https://github.com/openmhz/trunk-server
+   cd trunk-server
+   ```
+
+2. **Copy example environment file:**
+   ```bash
+   cp test.env.example test.env
+   ```
+
+3. **Edit the environment file:**
+   ```bash
+   nano test.env
+   ```
+   Add the following:
+   ```bash
+   export S3_PROFILE='default'
+   export S3_REGION='us-east-1'
+   export S3_ENDPOINT='http://minio.domain.com:9000'
+   export S3_BUCKET='bucketname'
+   ```
+   Save and exit.
+
+4. **Adjust `uploads.js` to work with MinIO path:**
+   ```bash
+   nano ~/trunk-server/backend/controllers/uploads.js
+   ```
+   - In Nano, press `ALT+n` to show line numbers.
+   - Around line 50, add the following crucial line:
+     ```javascript
+     const client = new S3Client({
+       requestHandler: new NodeHttpHandler({
+         httpsAgent: agent,
+       }),
+       credentials: fromIni({ profile: s3_profile }),
+       endpoint: s3_endpoint,
+       region: s3_region,
+       maxAttempts: 2,
+       forcePathStyle: true,
+     });
+     ```
+
+5. **Build and start the server:**
+   ```bash
+   ./docker-test.sh build   # This will take a while
+   ./docker-test.sh up -d   # This starts the server as a daemon
+   ```
+
+6. **Make sure you have the following commands available when running `./docker-test.sh`:**
+   ```bash
+   ./docker-test.sh build
+   ./docker-test.sh up -d
+   ./docker-test.sh down
+   ```
+
+## Creating Accounts (without an email server)
+
+1. Go to `account.(yourtrunkservername).(yourdomain).com`.
+2. Click **Register**.
+3. Fill out the form and click **Register** (nothing will happen right away).
+4. Connect to the right Docker container:
+   ```bash
+   docker exec -i -t $(docker ps -a | grep mongo | awk '{print $1}') /bin/bash
+   ```
+
+5. **Access MongoDB shell:**
+   ```bash
+   mongosh
+   ```
+
+6. **Select the `scanner` database:**
+   ```bash
+   use scanner
+   ```
+
+7. **Find and update user to confirm email:**
+   ```bash
+   db.users.find()
+   db.users.updateOne(
+      { "_id" : ObjectId("63a620d0a63b087b005f6726") },
+      {
+        $set: { "confirmEmail" : true },
+        $currentDate: { lastModified: true }
+      }
+   )
+   ```
+
+## Useful Commands
+
+### TrunkServer Logs:
+```bash
+docker-compose logs --follow --tail 50
+```
+
+### Build, Stop, and Start TrunkServer:
+```bash
+./docker-test.sh build

From e5db4f9f241defa631f5512f6f2669e51213e388 Mon Sep 17 00:00:00 2001
From: SubBass100 <60083876+SubBass100@users.noreply.github.com>
Date: Fri, 17 Jan 2025 07:43:25 -0500
Subject: [PATCH 2/4] Update Local_with_MINIO.MD

---
 Local_with_MINIO.MD | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Local_with_MINIO.MD b/Local_with_MINIO.MD
index f06de3a..eb37f69 100644
--- a/Local_with_MINIO.MD
+++ b/Local_with_MINIO.MD
@@ -1,4 +1,3 @@
-```markdown
 # Installing Trunk-Server Locally (no HTTPS)
 
 ## Prerequisites:

From ec58e5fcf75db2345538ba0455a47d9087347c8d Mon Sep 17 00:00:00 2001
From: SubBass100 <60083876+SubBass100@users.noreply.github.com>
Date: Fri, 17 Jan 2025 07:46:40 -0500
Subject: [PATCH 3/4] Rename Local_with_MINIO.MD to local-dev-with-minio.MD

Instructions to get Trunk-Server dev running entirely Local using MIN.IO for storage. Please take note that this does NOT cover SSL and should not be used as an edge facing service as it is not secure.
---
 Local_with_MINIO.MD => local-dev-with-minio.MD | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename Local_with_MINIO.MD => local-dev-with-minio.MD (100%)

diff --git a/Local_with_MINIO.MD b/local-dev-with-minio.MD
similarity index 100%
rename from Local_with_MINIO.MD
rename to local-dev-with-minio.MD

From b5c6d47f810fe16a4bd652ebbd6fa15ab391f2f9 Mon Sep 17 00:00:00 2001
From: SubBass100 <60083876+SubBass100@users.noreply.github.com>
Date: Fri, 17 Jan 2025 07:48:05 -0500
Subject: [PATCH 4/4] Update local-dev-with-minio.MD

final update
---
 local-dev-with-minio.MD | 1 +
 1 file changed, 1 insertion(+)

diff --git a/local-dev-with-minio.MD b/local-dev-with-minio.MD
index eb37f69..9ef8769 100644
--- a/local-dev-with-minio.MD
+++ b/local-dev-with-minio.MD
@@ -1,4 +1,5 @@
 # Installing Trunk-Server Locally (no HTTPS)
+*** Warning: Instructions to get Trunk-Server dev running entirely Local using MIN.IO for storage. Please take note that this does NOT cover SSL and should not be used as an edge facing service as it is not secure. ***
 
 ## Prerequisites: