SUNA
Local🔒 Most private

Install SUNA Home

Step by step, no prior knowledge needed. You copy a few commands, SUNA does the rest. Allow about 15 minutes.

Where should SUNA run?

  1. Raspberry Pi

    A Raspberry Pi 4 or 5 with Raspberry Pi OS (64 bit, “Lite” is enough). The Raspberry Pi Imager writes the system to the memory card and lets you turn on SSH right away. Remember the user name and password you set there.

    Important: the computer is on the same network as your inverter or its stick and runs around the clock. Only then does SUNA record without gaps.

  2. Open a terminal

    The easiest way is SSH from your PC. Open a terminal there (Windows: “PowerShell”, Mac: “Terminal”) and sign in to the Pi. Replace “user” with your user name from the Imager and the example address with your Pi’s address, which you find in your router.

    ssh user@192.168.178.20

    If the terminal asks for a password, it is your password for this computer. Nothing appears while you type, that is normal.

  3. Install curl

    curl downloads files from the internet. Docker and SUNA need it for the installation.

    sudo apt update && sudo apt install -y curl

  4. Install Docker

    SUNA runs in Docker, a kind of sealed box for programs. Your system stays clean, and SUNA can be updated or removed with one command.

    Docker’s official script installs everything in a few minutes.

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

    Check that Docker is running. Details about client and server appear:

    sudo docker version

  5. Install SUNA Home

    One command downloads SUNA Home in the right version for your computer, checks the file and starts SUNA. This takes one to three minutes. At the end it shows the address where you open SUNA.

    Loading the command …

  6. Open in the browser and set up

    • Open the address on a phone or PC on the same network, for example http://192.168.178.20:8080. On the computer itself, http://localhost:8080 works too.
    • Create the account for your SUNA Home. It is a separate account just for this computer, not your account on this website.
    • Under Setup, Inverter, choose your device and enter the details. What you need to prepare on the inverter is on the devices page. Go to the devices page
    • Without a key, SUNA runs for 30 days to try it out. Your license key is under My account; in SUNA you enter it under Setup, License.

  7. Later

    Update

    Create a new install command and run it. Your data stays.

    Is SUNA running?
    sudo suna status
    Restart
    sudo suna neustart
    Show the log
    sudo suna protokoll
    Forgot the SUNA Home password (readings stay, create a new account right after)
    sudo suna passwort
    Remove SUNA (asks first whether the readings should go too)
    sudo suna entfernen

If something gets stuck

Docker says “permission denied”

Put “sudo” in front of the command. As root, for example in the Proxmox container, you do not need it.

The terminal says “sudo: command not found”

You are signed in as root. Simply leave out “sudo”.

Port 8080 is already in use

Another program uses this port. The install script tells you what to do. Without the script, write for example -p 8081:3000 in the second command and open SUNA on port 8081.

Proxmox: Docker does not start in the container

Turn on “Nesting” and “keyctl” under Options, Features and restart the container.

The page does not load

Check that the phone or PC is on the same network and the address is right. On Windows, Docker Desktop must be running, and the Windows firewall may block access from your phone.

More questions? Have a look at the FAQ or write to hallo@suna.solar. FAQ

SUNA HomeSUNA runs on a small computer in your home and reads your inverter directly. Your measurements never leave your house, and you see them every second. More about SUNA Home