Skip to main content

11. Access SMHUB via External SSH client

🧭 How to Access SMHUB via SSH (Using PuTTY)

⚙️ This guide helps you connect to your SMHUB device remotely using SSH (Secure Shell) and update it via two simple commands.


🪄 Step 1: Download PuTTY

📸 [Insert screenshot: PuTTY download page]image.png


🪪 Step 2: Open PuTTY

  1. After installation, open the PuTTY program.
    You will see the main configuration window.

📸 [Insert screenshot: PuTTY main window]image.png


🌐 Step 3: Enter SMHUB IP Address

    Start your SMHUB. Wait until Blue LED chase effect stops (for firmwares >0.2.x). This means that SMHUB is ready for SSH connection.

    In the “Host Name (or IP address)” field, type your SMHUB’s IP address.

    • Example: 192.168.1.150115

    Make sure Port is set to 22.

    Ensure Connection type is set to SSH.

    Click the “Open” button.

    Optionally, Save your settings for future use. 

    📸 [Insert screenshot: PuTTY with IP address filled]image.png

    💡 If you don’t know your SMHUB IP, you can usually find it in your router’s “Connected Devices” list, under a name like smhub.local. orInstead of IP address, in PuTTY Host Name, you can enter SMLIGHT-SMHUBsmhub.local . It will work, if your network supports mDNS. If your network does not support mDNS, IP address like 192.168.1.115 should be used.


    🔐 Step 4: Accept Security Warning

    1. The first time you connect, a security alert may appear.
      Click “Yes” to trust this device.

    📸 [Insert screenshot: PuTTY Security Alert window]


    👤 Step 5: Log In

    When the black terminal window opens:

    1. At the prompt login as:, type:


      smlight
    2. When asked for password, type:


      smlight

      (Note: you will not see any stars or dots while typing —- that’s normal.)

    📸 [Insert screenshot: login prompt and successful login]image.png


    🧱 Step 6: Update SMHUB Software

    Once logged in, run the following two commands one by one:

    1️⃣ Update the package list:


    sudo opkg update

    Wait until the command finishes (you will see lines of text ending with “done”). System will ask for password. Please use the same password smlight

    image.png

    2️⃣ Upgrade all installed packages:


    sudo opkg upgrade

    This may take a few minutes —- don’t close the window during the process.

    📸 [Insert screenshot: commands running in terminal]image.png


    ✅ Step 7: Done!

    Once finished, type:


    exitsudo reboot now

    PuTTYYou can close the window without any commands as well.

    Your SMHUB will close.reboot.
    Your SMHUB is now updated and ready to use 🎉


    💡 Quick Summary

    Action Command / Button
    Login username smlight
    Login password smlight
    Update packages sudo opkg update
    Upgrade packages sudo opkg upgrade
    Exit session exit

    W