# WeatherStar

WeatherStar is a self-hosted weather forecast web app that recreates the iconic 1990s The Weather Channel aesthetic with minimal configuration, delivering classic blue-and-orange forecast graphics in a modern,. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3464/weatherstar

## Description

WeatherStar is a self-hosted weather forecast web app that recreates the iconic 1990s The Weather Channel aesthetic with minimal configuration, delivering classic blue-and-orange forecast graphics in a modern, easy-to-use interface.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

74/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 8 days ago)
- Popular: 66 (2,083 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 70 (no serious findings, 9 minor, CI, tests)

## Links

- Unraid: https://ca.unraid.net/apps/weatherstar-0oehso0156xvgc?q=WeatherStar
- Official website: https://weatherstar.netbymatt.com

## Common questions

### Can WeatherStar display forecasts for locations outside the United States?

No, it is tightly coupled to NOAA's Weather API, which is exclusive to the United States. The README points to a separate fork for international locations.

### What port does the quick start use when running locally?

After running npm start, open the browser to localhost port 8080.

### Which deployment mode is recommended?

WeatherStar supports two deployment modes, and server deployment is recommended.

### What information should I provide if my WeatherStar container is acting badly?

The community thread asks for how long the container has been running, the CPU, the docker run command, and whether tile screens were changed from the default ws4kp container.

### Does WeatherStar use caching to keep API usage reasonable?

It lists practical API rates and static asset caching as part of the implementation.

---
Source: Our Local Host (https://ourlocalhost.com/app/3464/weatherstar), the self-hosted and open-source app directory.
