Setting Up and Running Dashy on a Raspberry Pi

Dashy is a powerful and customizable dashboard application that allows you to manage and visualize your favorite web services, tools, and resources in one place. Running Dashy on a Raspberry Pi enables you to have a centralized control panel for your network and applications, perfect for home servers and small networks.

What You Will Need

Raspberry Pi (3, 4, or later is recommended)
MicroSD Card (at least 8GB, Class 10 or better)
Power Supply (5V, 2.5A minimum for Pi 3; 5V, 3A for Pi 4)
Raspberry Pi OS (Lite or Desktop, depending on preference)
Internet Connection
Docker Installed (or Node.js if running manually)

Step 1: Prepare the Raspberry Pi

Update the Raspberry Pi:
```
sudo apt update && sudo apt upgrade -y
```
Install necessary tools:
```
sudo apt install -y curl git
```

If not already installed, install Docker:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Add your user to the Docker group:

sudo usermod -aG docker $USER

Reboot the Raspberry Pi:

sudo reboot

Step 2: Install Dashy Using Docker

Dashy can be quickly deployed using Docker. Follow these steps to get Dashy up and running:

Pull the Dashy Docker image:
```
sudo docker pull lissy93/dashy
```
Create a directory for Dashy configuration:
```
mkdir -p ~/dashy/conf
```

Run the Dashy container:

sudo docker run -d \
  -p 8080:80 \
  -v ~/dashy/conf:/app/public/conf \
  --name dashy \
  lissy93/dashy

Access Dashy in your browser:
```
http://<raspberry-pi-ip>:8080
```

Step 3: Configure Dashy

Dashy uses a config.yaml file to define the layout and content of your dashboard.

Open the configuration directory:
```
nano ~/dashy/conf/config.yaml
```

Modify the file to include your services. Here’s a simple example:

appConfig:
  title: "My Dashboard"
  description: "Centralized control panel for my services"

sections:
  - name: "Network Tools"
    items:
      - title: "Router"
        url: "http://192.168.1.1"
        icon: "fas fa-network-wired"
      - title: "NAS"
        url: "http://192.168.1.100"
        icon: "fas fa-server"
      - title: "OctoPrint"
        url: "http://192.168.1.50"
        icon: "fas fa-print"

Save the file and restart Dashy to apply changes:
```
sudo docker restart dashy
```

Step 4: Optional Enhancements

Enable HTTPS: Use a reverse proxy like Nginx or Traefik to secure Dashy with HTTPS.
Customize Appearance: Dashy supports themes and layout customization. Modify the appConfig section in config.yaml:
```
appConfig:
  theme: "hacker"
```
Run Dashy on a Custom Port: Change the port mapping when running the Docker container:
```
sudo docker run -d -p 3000:80 ...
```
Set Up Auto-Start: Ensure Dashy starts on boot by creating a Docker systemd service:
```
sudo systemctl enable docker
```

Troubleshooting

Dashy Not Accessible:
- Verify the container is running:
```
sudo docker ps
```
- Check for errors in the container logs:
```
sudo docker logs dashy
```
Configuration Changes Not Applied:
- Ensure config.yaml is saved in the correct directory.
- Restart the Dashy container after making changes.
High Resource Usage:
- Reduce the number of services and widgets in your dashboard.
- Upgrade to a Raspberry Pi 4 for better performance.

Applications of Dashy

Centralized control panel for managing network services.
Quick access to home automation tools and media servers.
Monitoring IoT devices and local applications.
Personalized dashboard for daily productivity.

Conclusion

Dashy provides a versatile and customizable dashboard solution for organizing and managing your web services. By following this guide, you can set up and run Dashy on a Raspberry Pi, creating a centralized hub for your tools and resources. Experiment with different configurations and themes to make Dashy your ultimate control panel!