A Node.js/TypeScript application for collecting and storing SleepNumber bed statistics in Victoria Metrics and sending data to Fitbit.

• Collects nightly sleep data from SleepNumber API
• Stores data in Victoria Metrics
• Optionally sends sleep sessions to Fitbit

docker run --rm --init \
  -v $(pwd)/config:/app/config \
  -p 3000:3000 \
  -e TZ=America/New_York \
  -e CONFIG_PATH=/app/config \
  ghcr.io/claabs/sleepnumber-stats

services:
  sleepnumber-stats:
    image: ghcr.io/claabs/sleepnumber-stats
    init: true
    environment:
      TZ: "America/New_York"
    ports:
      - 3000:3000 # optional, for Fitbit setup
    volumes:
      - ./config:/app/config
    restart: unless-stopped

All application configuration is provided via a config.json file. The optionaly environment variables are:

• TZ: Set this to your desired timezone (e.g., America/New_York, UTC, Europe/London). Default is UTC if not set.
• CONFIG_PATH: Path to the configuration directory containing config.json. Default is /app/config.

• The /app/config volume stores authentication tokens and should be mounted to retain login state between runs.

{
  "sleepNumberEmail": "your@email.com",
  "sleepNumberPassword": "yourpassword",
  "victoriaMetricsUrl": "http://victoriametrics:8086",
  "victoriaMetricsAuth": {
    "username": "admin",
    "password": "passwort",
  },
  "deleteMetrics": false,
  "tz": "America/New_York",
  "logLevel": "info"
}

To enable the Fitbit reporting of sleep data to your Fitbit account (for syncing to your phone):

1. Setup an HTTPS domain reverse proxied to your container

2. Create a Fitbit developer application:

   1. Create an app on the Fitbit dev portal
   2. Set OAuth 2.0 Application Type to Personal if only you are using it, or Server if accounts other than the developer's account will connect
   3. Set Redirect URL to your HTTPS URL set in the config fitbitBaseUrl
   4. Set Default Access Type to Read & Write

3. Add the Fitbit options to your config:

   {
     ...existing config fields...
     "fitbitRedirectUri": "https://sleep.example.com/callback",
     "fitbitClientId": "12ABCD",
     "fitbitClientSecret": "abcdef1234567890abcdef1234567890"
   }

4. Open a terminal inside your running container and run ./setup.sh:

   docker exec -it sleepnumber-stats sh
   ./setup.sh

5. Navigate to /register (e.g. https://sleep.example.com/register)

6. Click the sleeper you'd like to associate with your Fitbit account and follow the Fitbit linking steps

7. CTRL-C in the terminal to exit the setup application

8. The Fitbit data will be uploaded on your next scheduled run. You should see your Fitbit refresh token in /app/config/tokens.json.