Please Note I am runnign Mac OS, namely a MAC M1 Studio. it has it quirks like everything else. I will try to update and include windows
There are various ways to install diode, I will start with the client download, assuming you have a Raspberry Pi with Linux its as simple as running the following:
curl -Ssf https://diode.io/install.sh | bash
Supported on macOS, Linux, Raspberry Pi (or Windows if you have curl)
Once you have it installed, what can you actually do with the diode client, this is where the fun begins, you can run diode config and it will show a number of things
INFO Diode Client version : v0.13.6-1-g8d855fe-dirty 04 Mar 2024
INFO Client address : 0xe78aab27d263cc497a20411793d391355XXXXXXX
INFO Fleet address : 0x8831c475ab58809f24925075d341861XXXXXXXX
INFO <KEY> : <VALUE>
INFO fleet : 0x8831c475ab58809f24925075d341861XXXXXXXX
INFO last_update_at : 0x66260431
INFO lvbh3 : 0x00003b7f84358bf7cfea1074bb22d178e5044cd30aa452d5642XXXXXXXXXXXXX
INFO lvbn3 : 0x69XXXX
INFO <address> : 0xe78aab27d263cc497a20411793d391355XXXXXXX
INFO private : <********************************>
Congratulations you just installed Diode client, now lets look at publishing something. lets keep it simple and use a local webserver on port 80, you would run the following ./diode -public 80:80 the output will show the address
-
You can publish local content from the installed pc our to something like http://0x70114a27f3d1b549012498c69a4120ca4ea11e21.diode.link/
enter that or click on the link and you will see your webserver. -
To make this more user friendly you can assign a BNS name using the client, paying attention to the client address, again will be displayed with ./diode config to assign a BNS name, run the following:
./diode bns -register my-webserver (make sure it is 8 characters or more) wait a few minutes and once it completes, you can enter the URL as https://my-webserver.diode.link
a great article for further info and to see more options can be located at Publish a website from your local network
In the next post I will expand on how you can run your own cloud service with diode and build on this simple example.