MediaNest

A web application designed to run as a mini HomeLab host on a family mini PC. It provides a convenient UI to manage albums, upload and browse images, and handle user access.

✨ Features

• 🌄 Album Service

  • Upload images file
  • Tag-based search system
  • Browse image collections with dropdown-view or page-view

• 🔑 User System

  • Login & Registration
  • Role-based access control
  • Admin Panel for user management

🛳️ Deployment

MediaNest supports Docker Compose for one-click deployment.
This will start Blazor frontend + WebAPI + MongoDB together.

default administrator account username : admin password : admin

1. Clone the repository

git clone https://github.com/tigercat0828/MediaNest.git
cd MediaNest

2. Create .env file and edit

echo ASSETS_PATH=/absolute/path/to/your/assets > .env
vi .env   # or use your favorite editor

3. start the services

docker compose up -d

For developers (rebuild after code changes):

docker compose up -d --build

If cache issues occur:

docker compose build --no-cache
docker compose up -d

🖼️ Screenshots

🛠️ Tech Stack

• Blazor Server
• ASP.NET core WebAPI
• MongoDB (document-based storage for users, albums, metadata)
• Bootstrap 5 (UI components & responsive layout)

📋 Prerequisites

Before running the project, make sure you have:

• .NET 10 Runtime
• A running MongoDB service

🛳️ Roadmap

• Video service (upload & stream videos)
• Musci service

Jenkins CI/CD

(not finished) Ctrl+R secpol.msc 設定本機 以服務登入 通過Jenkins Credential Test

@echo off
:: 1. 設定變數
set ASSETS_PATH=<your_assets_folder_path>

:: 2. 停止並移除舊的容器、網路（但保留 Volume 數據）
:: --remove-orphans 可以順便清理不再使用的容器
echo "Cleaning up old containers..."
docker compose down --remove-orphans

:: 3. 重新啟動並編譯
echo "Starting Docker Compose..."
docker compose up -d --build

• setup workdir
• mongodb restore program