Downloads Removed GitHub

Troubleshooting deployment-packages/DOWNLOADS-REMOVED-GITHUB.md

Downloads Removed - GitHub Integration Complete

Summary

Downloads have been removed from the Marketing site and replaced with GitHub repository clone instructions.

Changes Made

1. GetStarted.razor - Updated Download Section

Changed From: Local ZIP file downloads
Changed To: GitHub repository clone instructions

New Download Section:

Displays GitHub clone command
Links to GitHub repository
Provides "View on GitHub" button

2. Installation Instructions Updated

Windows Deployment (Step 3):

# Clone repository
git clone https://github.com/JoshuaBylotas/MCBDSHost.git
cd MCBDSHost

# Create directory for deployment
New-Item -Path "C:\MCBDSHost" -ItemType Directory -Force
Copy-Item -Path "docker-compose.windows.yml" -Destination "C:\MCBDSHost\"
Set-Location "C:\MCBDSHost"

Linux Deployment (Step 2):

# Clone repository
git clone https://github.com/JoshuaBylotas/MCBDSHost.git
cd MCBDSHost

# Copy deployment files
sudo mkdir -p /opt/mcbdshost
sudo cp docker-compose.linux.yml /opt/mcbdshost/
cd /opt/mcbdshost

3. MCBDS.Marketing.csproj - Removed Downloads Reference

Removed <Content Update="wwwroot\downloads\**"> section
Only keeping sitemap.xml and robots.txt content items

4. web.config - Removed ZIP MIME Type

Removed <mimeMap fileExtension=".zip" mimeType="application/zip" />
No longer needed since we're not serving ZIP files

5. File System Cleanup

Deleted:

MCBDS.Marketing/wwwroot/downloads/ folder (and all contents)
deployment-packages/windows-package/ folder
deployment-packages/linux-package/ folder
deployment-packages/create-download-packages.ps1
deployment-packages/deploy-marketing-with-downloads.ps1

Benefits of GitHub Approach

Advantages

Always up-to-date - Users get latest code directly from GitHub
No hosting overhead - No need to maintain ZIP packages
Version control - Users can checkout specific releases/tags
Better for contributors - Easier for open source contributions
Simpler deployment - No need to regenerate packages
Full transparency - Users see all source code and history

User Experience

Visit website
Clone repository from GitHub
Copy docker-compose files to deployment directory
Download Minecraft server separately
Run Docker Compose
Access Web UI

GitHub Repository

URL: https://github.com/JoshuaBylotas/MCBDSHost

Users can:

Clone the repository
View all source code
Check releases and tags
Report issues
Contribute via pull requests
Star the repository

Updated Deployment Flow

For Windows:

Install prerequisites (Hyper-V, Containers, Docker)
Install Docker Desktop
Clone GitHub repository (new)
Copy docker-compose.windows.yml to C:\MCBDSHost
Download Minecraft Bedrock Server
Configure firewall
Start services with Docker Compose

For Linux:

Install Docker
Clone GitHub repository (new)
Copy docker-compose.linux.yml to /opt/mcbdshost
Download Minecraft Bedrock Server
Configure firewall
Start services with Docker Compose

What Users Get

From GitHub Repository:

Complete source code
Docker Compose files (Windows & Linux)
Dockerfiles for all services
Documentation
README files
License information

What They Still Download Separately:

Minecraft Bedrock Dedicated Server from official Minecraft website
- This is required and cannot be redistributed
- Clear instructions provided

Build Status

Build successful
Downloads removed
GitHub integration complete
Ready to deploy

Deployment

Deploy the updated Marketing site:

cd MCBDS.Marketing
dotnet publish -c Release -o bin\Release\net10.0\publish
Copy-Item -Path "bin\Release\net10.0\publish\*" -Destination "C:\inetpub\wwwroot\mc-bds-marketing\" -Recurse -Force
iisreset

Verification

After deployment, verify:

Get Started Page: https://www.mc-bds.com/get-started
- Should show GitHub clone instructions
- Should have "View on GitHub" button
- No ZIP download links
GitHub Link: Should open https://github.com/JoshuaBylotas/MCBDSHost
No 404 Errors:
- /downloads/mcbdshost-windows.zip should not exist (expected)
- /downloads/mcbdshost-linux.zip should not exist (expected)

Files Modified

File	Change
`GetStarted.razor`	Replaced downloads with GitHub clone
`MCBDS.Marketing.csproj`	Removed downloads folder reference
`web.config`	Removed .zip MIME type

Files Deleted

File/Folder	Reason
`wwwroot/downloads/`	No longer hosting downloads
`deployment-packages/windows-package/`	Not needed
`deployment-packages/linux-package/`	Not needed
`create-download-packages.ps1`	Not needed
`deploy-marketing-with-downloads.ps1`	Not needed

Documentation Updates Needed

Consider updating these docs (if they reference downloads):

DOWNLOADS-IMPLEMENTATION.md - Mark as obsolete
DOWNLOADS-QUICK-FIX.md - Mark as obsolete
Any other docs mentioning /downloads/ URLs

Status: COMPLETE - READY FOR DEPLOYMENT

Updated: December 30, 2024
Approach: GitHub Repository Clone
Previous: Local ZIP Downloads

Back to Documentation Index Back to Top