Dynacat Proxmox Homelab Dashboard Setup

This directory contains pre-configured files to deploy and customize the Dynacat dashboard (a real-time, self-hosted feed and service aggregator) for your homelab.

File Structure

config/dynacat.yml: The main configuration file, styled in a custom dark HSL theme and pre-loaded with all your 14 active homelab services.
assets/news.html: A custom, Google-News-style news portal that aggregates your RSS feeds into a visual card grid.
docker-compose.yml: A compose template for deploying Dynacat in a Docker environment (such as a Docker-enabled VM or LXC).

How to Apply to Your Proxmox Setup

Choose the installation method that matches how you deployed Dynacat:

Option A: If using Proxmox LXC (Helper Script)

If you installed Dynacat directly as an LXC container using a Proxmox VE Helper Script (e.g. from Community Scripts / tteck):

Locate the Target Paths: Inside the container, Dynacat looks for configuration and assets at:
- Config file: /opt/dynacat/config/dynacat.yml
- Assets folder: /opt/dynacat/assets/news.html

Transfer the Files: You can copy the local files to your LXC container using SCP:

# Replace <LXC_IP> with the IP address of your Dynacat LXC (e.g. 192.168.1.146)
# Copy the configuration file:
scp config/dynacat.yml root@<LXC_IP>:/opt/dynacat/config/dynacat.yml

# Copy the news portal asset file:
scp assets/news.html root@<LXC_IP>:/opt/dynacat/assets/news.html

Alternatively, you can edit the file directly inside the LXC container's terminal using nano /opt/dynacat/config/dynacat.yml and paste the contents of the generated dynacat.yml.

Apply Changes: Dynacat supports live config reloading and will detect updates automatically upon saving. If you need to manually restart the service, run:
```
systemctl restart dynacat
```
Set Up API Tokens (Inline Configuration): Instead of setting systemd environment variables, you can input your API keys directly inside the dynacat.yml file on your server (by replacing "your_grocy_token_here", etc.):
- Edit the file on your server:
```
nano /opt/dynacat/config/dynacat.yml
```
- Replace the placeholder string values with your actual API keys/tokens.
- Save and close the file. Dynacat will automatically pick up the new configuration!

Option B: If using Docker Compose (VM or LXC with Docker)

If you are running Dynacat inside a VM or LXC that runs Docker:

Copy both docker-compose.yml and the config/ directory to your target folder on Proxmox.
Spin up the container:
```
docker compose up -d
```
Open your browser and navigate to http://<YOUR_DOCKER_HOST_IP>:8080.

Customization Guide

1. Weather Location

Open config/dynacat.yml and locate the weather widget:

- type: weather
  location: "La Crosse, Wisconsin"  # Set to your location
  units: imperial                  # Change to 'metric' for Celsius

2. Dashboard Icons

We have pre-configured icons for your services using two libraries:

Simple Icons (si:): High-quality vector icons for popular brands.
Material Design Icons (mdi:): General icons (like gamepad, cloud, trash can).

Example of a custom link with an icon:

- title: Audiobookshelf
  url: https://books.jonahlahona.com
  icon: si:audiobookshelf

You can search for more icons on:

Simple Icons: simpleicons.org
Material Design Icons: pictogrammers.com/library/mdi/
Selfh.st Icons: sh:<icon_name> (e.g., sh:immich)
Dashboard Icons: di:<icon_name>

3.6 KiB Raw Blame History