Skip to content

Install

This guide tells you how to install sshwifty (https://github.com/nirui/sshwifty.md)

Notes

We use here some redirection stuff, because it is not possible to use a webserver and the sshwifty without port

Running as yourself

Install

Firstly you have to go to [[https://github.com/nirui/sshwifty/releases/]] and download sshwifty__openbsd_amd64.tar.gz

At the moment of making this guide is that: [[https://github.com/nirui/sshwifty/releases/download/0.2.20-beta-release-prebuild/sshwifty_0.2.20-beta-release_openbsd_amd64.tar.gz]]

So what we do is:

$ mkdir ~/sshwifty
$ cd ~/sshwifty
$ wget https://github.com/nirui/sshwifty/releases/download/0.2.20-beta-release-prebuild/sshwifty_0.2.20-beta-release_openbsd_amd64.tar.gz
$ tar -xzf sshwifty_0.2.20-beta-release_openbsd_amd64.tar.gz##ENDCODEBLOCK##
### Setup
For the config it is very simple:
$ cp sshwifty.conf.example.json config.json
$ nano config.json##ENDCODEBLOCK##
You can set the hostname, then if you don't go to the domain then you wont be seeing the page
You can edit the "SharedKey", this is what you need to login/use the sshwifty
You can edit the presets to what you want
Create SSL certs and put them into the "TLSCertificateFile" and "TLSCertificateKeyFile" (Recommended to copy them to your folder and chown it to you, so no perms errors)
Now open your /etc/httpd.conf and add:
server "ssh.YOURHOSTNAME" {
        listen on * port 8080
        location * {
                block return 302 "https://ssh.YOURHOSTNAME:8182$REQUEST_URI"
        }
}

and restart httpd

Then allow port 8182 at your pf.conf (add to the http one)

And reload your pf: ##STARTCODEBLOCK## $ doas pfctl -f /etc/pf.conf##ENDCODEBLOCK##

Starting

To start the sshwifty, I recommend to create a start script:

start.sh

#!/bin/ksh
SSHWIFTY_CONFIG=./config.json ./sshwifty_openbsd_amd64

And ##STARTCODEBLOCK## chmod +x start.sh##ENDCODEBLOCK##

Then do ##STARTCODEBLOCK## ./start.sh##ENDCODEBLOCK##

and you should be good to go


Copyright (C) 2021 by Miniontoby miniontoby@ircnow.org