The “Advanced SSH & Web Terminal” community add-on for the Home Assistant home automation package is a really awesome utility written by a guy who seems to have a bit of a surly attitude towards his users. (Hard as it is to imagine a developer with a surly attitude.) Following lots of questions about his poor documentation and comments from him resisting being in any way helpful, I put together this quickstart guide for those hapless folks who like myself who were initially trapped by 502 errors (see bad gateway 502, issue #684 in the Github repo) in using this add-on due to the very unclear documentation.
For those here with this problem, here is the “quickstart” documentation the Home Assistant “Advanced SSH & Web Terminal” community add-on package is missing:
1.) After install, the tabs for the documentation, configuration, and logs are at the top of the page:
2.) fill in a username and password in the Configuration tab.
Note: The Documentation tab (also available in this repo at https://github.com/hassio-addons/addon-ssh/blob/main/ssh/DOCS.md) gives more info about options you can use here. To be extra-secure you really should set up keys, which you can find info about in the Documentation, but this is a quickstart, so to get this mother love bone rolling we’ll just pick a username and password.
3.) After entering a username and password, be sure to scroll to the bottom of that Options block and click ‘save’.
Note: Be careful! There are several “save” buttons on that tab, one for each block. If you click the wrong ‘save’ button, it won’t tell you there’s a problem, but it won’t save your chosen username & password! If you have problems later in this process, come back to this step and make sure you saved your username and password correctly.
4.) Go back to the Info tab, then click ‘Start’.
5.) Some CPU & RAM meters and a link for “Open Web UI” will appear. Click “Open Web UI”.
6.) Ta-daa! You’re in. Or, at least, I was, by following those steps. YMMV.
You can now SSH in from a normal SSH client, using the name and password you set up in step 2.
November 21, 2021This one drove me crazy for a few weeks, and the solution was tough to find, so I’m posting it here. I would be working on my laptop and my screen would suddenly black out and the computer would randomly go to sleep as I was typing. I’d have to hit a key to wake […]
June 23, 2018I do a lot of posting to Tumblr to archive notes on interesting things I’ve read online. Tumblr’s default sharing bookmarklet and browser extensions have two serious drawbacks: 1.) They either create photo or link posts, nothing else 2.) They frequently don’t work at all: the share window opens, and then the “spinner” graphic sits […]
April 21, 2017TL;DR: I edit scripts in TamperMonkey (GreaseMonkey replacement) and have the changes automatically update a master GitHub repo by backing TamperMonkey up to Dropbox, then having an OS X Folder Action perform the GitHub update. Here’s a pretty arcane trick that hopefully will be of use to some other person, somewhere, someday. In my GitHub repo I have shared a […]
October 4, 2016Summary: The Terminal command “sudo spctl –master-disable” can restore the option to open apps from anywhere without Sierra giving you a warning. The General tab in the “Security & Privacy” System Preference used to show you three settings for where it would allow you to open applications from without complaining: just the Apps Store, just […]
September 28, 2016TL;DR, for tech geeks: For SEO purposes, I needed multiple rewrite rules in my .htaccess file for this site: Make sure URLs for directories (basically everything except images and external javascript and css files, since this is a wordpress site) always end in a slash. Make sure URLs always redirect to www.kupietz.com, not just kupietz.com Make sure […]
November 12, 2014Often in recent versions of OS X, new Finder windows open with the Name column, the first column on the left, much too wide, pushing the other columns past the right edge of the window. I found a solution that seems to fix this. 1.) Open a new finder window 2.) If All the columns […]
Stay in touch
Michael Kupietz
Certified Expert FileMaker Pro Consultant & Full-Stack Web Developer
Serving clients locally and remotely, in California's San Francisco Bay Area and nationwide
1.) After install, the tabs for the documentation, configuration, and logs are at the top of the page:
2.) fill in a username and password in the Configuration tab.
Note: The Documentation tab (also available in this repo at https://github.com/hassio-addons/addon-ssh/blob/main/ssh/DOCS.md) gives more info about options you can use here. To be extra-secure you really should set up keys, which you can find info about in the Documentation, but this is a quickstart, so to get this mother love bone rolling we’ll just pick a username and password.
3.) After entering a username and password, be sure to scroll to the bottom of that Options block and click ‘save’.
Note: Be careful! There are several “save” buttons on that tab, one for each block. If you click the wrong ‘save’ button, it won’t tell you there’s a problem, but it won’t save your chosen username & password! If you have problems later in this process, come back to this step and make sure you saved your username and password correctly.
4.) Go back to the Info tab, then click ‘Start’.
5.) Some CPU & RAM meters and a link for “Open Web UI” will appear. Click “Open Web UI”.
6.) Ta-daa! You’re in. Or, at least, I was, by following those steps. YMMV.
You can now SSH in from a normal SSH client, using the name and password you set up in step 2.