trunk-server/Local_with_MINIO.MD

# 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:

   127.0.0.1       openmhz.test account.openmhz.test api.openmhz.test admin.openmhz.test media.openmhz.test
   

6. Flush DNS cache:

   sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
   

7. Create a file in your user's home directory for AWS credentials:

   mkdir ~/.aws
   nano credentials
   

   Add the following content to the file:

   [default]
   aws_access_key_id = [..]
   aws_secret_access_key = [..]
   

Install Docker (from Docker Docs)

1. Update and install prerequisites:

   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:

   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:

   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:

   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
• 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:

   git clone https://github.com/openmhz/trunk-server
   cd trunk-server
   

2. Copy example environment file:

   cp test.env.example test.env
   

3. Edit the environment file:

   nano test.env
   

   Add the following:

   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:

   nano ~/trunk-server/backend/controllers/uploads.js
   

   • In Nano, press ALT+n to show line numbers.
   • Around line 50, add the following crucial line:

     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:

   ./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:

   ./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:

   docker exec -i -t $(docker ps -a | grep mongo | awk '{print $1}') /bin/bash
   

5. Access MongoDB shell:

   mongosh
   

6. Select the scanner database:

   use scanner
   

7. Find and update user to confirm email:

   db.users.find()
   db.users.updateOne(
      { "_id" : ObjectId("63a620d0a63b087b005f6726") },
      {
        $set: { "confirmEmail" : true },
        $currentDate: { lastModified: true }
      }
   )
   

Useful Commands

TrunkServer Logs:

docker-compose logs --follow --tail 50

Build, Stop, and Start TrunkServer:

./docker-test.sh build