Skip to content

jetson-setup.md

Latest commit

 

History

History
80 lines (53 loc) · 2.11 KB

jetson-setup.md

File metadata and controls

80 lines (53 loc) · 2.11 KB

Jetson Setup Guide

Use this guide if your HomeBrain hub is a Jetson Orin Nano.

What You Need

  • Jetson Orin Nano with Ubuntu / JetPack already installed
  • Internet access on the Jetson
  • A browser on another device on the same network

Install

git clone <your-public-repo-url> HomeBrain
cd HomeBrain
bash scripts/install-jetson.sh

The script installs everything HomeBrain needs and creates the production service for you.

It also prepares the Ollama management helper and privilege wiring used by the HomeBrain UI on Jetson hosts. Clean installs use committed npm lockfiles, generate local JWT/session secrets, and default browser auth to HttpOnly cookies.

Open HomeBrain

Find the Jetson IP:

hostname -I

Then open:

http://<jetson-ip>:3000

What Is Different On Jetson

Jetson is still the best-tested hardware for:

  • local Whisper speech-to-text
  • local Ollama models
  • other GPU-accelerated workloads

HomeBrain itself is not limited to Jetson anymore, but Jetson is still the strongest all-in-one hub target.

After Install

Next steps:

  1. Create the first account
  2. Follow configuration.md
  3. Add remote listener devices from Voice Devices
  4. If you want a bedside touch/rotary controller, follow elecrow-wall-panel.md
  5. Before publishing or exposing the repo, run the checklist in security.md

Useful Commands

bash scripts/setup-services.sh status
bash scripts/setup-services.sh logs follow
bash scripts/setup-services.sh health
bash scripts/setup-services.sh refresh-privileges

Ollama On Jetson

On Jetson, HomeBrain manages Ollama from the host itself. The Ollama page installs or updates the Ollama binary through a narrow privileged helper, stops any foreign ollama system service if needed, and then restarts a single HomeBrain-managed runtime.

If an older Jetson install needs its Ollama helper or service privileges repaired, run:

bash scripts/setup-services.sh refresh-privileges
sudo systemctl restart homebrain

More detail: