whatisgithub

What is sunriselight?

j4ckxyz/sunriselight — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · generalComplexity · 2/5LicenseSetup · moderate

In one sentence

A self hosted Docker app that gradually brightens your Home Assistant lights each morning to mimic a natural sunrise, with optional weather adjustment for Jersey.

Mindmap

mindmap
  root((Sunrise Light))
    What it does
      Gradual light wake up
      Solar curve brightness
      Weather aware for Jersey
    Tech stack
      JavaScript
      Node.js
      Docker
      Home Assistant
    Use cases
      Natural wake up routine
      Scheduled dawn per light
      Safe accelerated testing
    Audience
      Home Assistant users
      Smart home hobbyists
      Self hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Wake up gradually with lights that mimic a real sunrise instead of a jarring switch to full brightness

USE CASE 2

Automate a gentle dawn routine for specific lights on chosen days of the week

USE CASE 3

Run a safe, restorable accelerated test before trusting the automation to run every morning

What is it built with?

JavaScriptNode.jsDockerHome Assistant

How does it compare?

j4ckxyz/sunriselight00kaku/gallery-slider-block0xkinno/vellum
Stars00
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-19
MaintenanceDormant
Setup difficultymoderateeasyhard
Complexity2/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker, Docker Compose, and a Home Assistant long-lived access token.

MIT license: use, modify, and share freely, including commercially, as long as you keep the copyright notice.

So what is it?

Sunrise Light is a small self hosted app that wakes up your smart lights the way the sun would. It connects to Home Assistant and gradually raises the brightness and colour temperature of chosen lights each morning, starting dim and warm and following a calculated solar curve toward full daylight. You set it up by running it as a Docker container on a computer, server, or NAS you already have at home. Once it is running, you open its dashboard in a browser, connect it to Home Assistant using a long lived access token, then pick which lights should take part and on which days of the week. You can also add an artificial delay for very early summer sunrises so you are not woken before you want to be, and cap how bright the lights get. For timing, Sunrise Light calculates sunrise for your coordinates automatically. If you are in Jersey, it also pulls in real weather conditions from the Government of Jersey weather feed. Everywhere else, it uses Sunrise-Sunset.org for the sunrise time and relies on the seasonal curve alone, without weather adjustment. If no online source is available, it falls back to its own astronomical calculation. A safe mode is turned on by default, and two separate settings both have to be turned on before the app is allowed to actually change your lights on a schedule, which helps you test timings safely first. There is also a one-off accelerated test mode with its own lower brightness limit that restores each light to how it was before the test. For remote access without exposing the app to the public internet, the README suggests running it alongside Tailscale. Home Assistant access is limited to reading light and automation states and turning lights on or off, and the app cannot create, edit, or delete any Home Assistant automations or scenes. It is written in JavaScript, needs Node.js 22 or newer for local development, and is released under the MIT licence.

Copy-paste prompts

Prompt 1
Walk me through setting up Sunrise Light with Docker Compose and connecting it to Home Assistant
Prompt 2
Explain how Sunrise Light calculates sunrise times and what the Jersey weather feed adds
Prompt 3
Help me configure a Tailscale route so I can reach my Sunrise Light dashboard remotely
Prompt 4
Show me how to safely test a sunrise schedule before enabling automatic control

Frequently asked questions

What is sunriselight?

A self hosted Docker app that gradually brightens your Home Assistant lights each morning to mimic a natural sunrise, with optional weather adjustment for Jersey.

What language is sunriselight written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Docker.

What license does sunriselight use?

MIT license: use, modify, and share freely, including commercially, as long as you keep the copyright notice.

How hard is sunriselight to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is sunriselight for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.