====== Install & Setup ======

===== Introduction =====

[[:start|SolarNET.HuB (SNH)]] has been built including a complex [[https://en.wikipedia.org/wiki/Distributed_Networking|distributed]] and [[https://en.wikipedia.org/wiki/Encryption|encrypted]] networking [[socialnet/engineering#architecture|architecture]] for semantic and relational layers... [[:socialnet/engineering|+info]]

===== Code of Conduct =====

In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in [[:start|SolarNET.HuB (SNH)]] and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation... [[:docs/code_of_conduct|+info]]

----

===== The Project Network =====

In [[:start|SolarNET.HuB (SNH)]] we are very aware of the need to __establish a different language__ (different perception of reality through the [[https://en.wikipedia.org/wiki/Semantic_layer|semantic layer]]) that allows us to create other types of relationships beyond those currently established by companies and governments. 

And specifically, the need to __rebuild the bases__ that make up the so called [[https://en.wikipedia.org/wiki/Social_network|social networks]], due to more useful, didactic, efficient environments and with a less infant character... [[:socialnet/ecosystem|+info]]

==== Installation ====

 * **KIT: "AR(n)Ti_FA.CT!"**

The [[:kit/overview|kit]] __includes the latest stable version__ of [[:socialnet/engineering#clientsnh-oasis|SNH-Oasis]], installed and configured.

{{ :kit:snh-overview.jpg?nolink&600 |}}

 * **Other devices**:

You can [[https://code.03c8.net/KrakensLab/oasis/src/master/docs/install.md|install]] the latest stable version of [[:socialnet/engineering#clientsnh-oasis|SNH-Oasis]] in __other different devices__. 

-> For a [[https://es.wikipedia.org/wiki/GNU/Linux|GNU/Linux]] based system (ex: [[https://en.wikipedia.org/wiki/Debian|Debian]]), execute the following steps (from a shell):

<code>
sudo apt-get install git curl
curl -sL http://deb.nodesource.com/setup_14.x | sudo bash -
sudo apt-get install -y nodejs
git clone https://code.03c8.net/KrakensLab/oasis
cd oasis
npm install .
npm run start
</code>

==== Updating ====

-> The [[https://solarnethub.com/socialnet/engineering#clientsnh-oasis|SNH-Oasis]] client __can be updated directly from the interface__. 

{{ :socialnet:snh-oasis_settings_updates.png?nolink&600 |}}

When there are new updates, a button will appear __to obtain the latest stable version of the code__.

 * **KIT: "AR(n)Ti_FA.CT!"**

-> __You will receive automatically the new functionalities__, changes, bug fixes, etc. for the [[:socialnet/start|project network]], made in the [[https://solarnethub.com/kit/software|kit]] [[https://code.03c8.net/krakenslab/|updates]].

 * **Other devices (manually)**:

-> For a [[https://es.wikipedia.org/wiki/GNU/Linux|GNU/Linux]] based system (ex: [[https://en.wikipedia.org/wiki/Debian|Debian]]), execute the following steps (from a shell):

<code>
cd oasis
git pull
npm install .
npm run start
</code>

==== Settings (minimal) ====

{{ :socialnet:snh-oasis_settings.png?nolink&600 |}}

==== Choose Language ====

{{ :socialnet:snh-oasis_language.png?nolink&600 |}}

==== Set Your Avatar ====

{{ :socialnet:snh-oasis_profile-1.png?nolink&600 |}}

==== Joining a PUB ====

1. Find the __Invite code__ of the [[:socialnet/engineering#publa_plaza|PUB]]:

{{ :socialnet:snh-pub.png?nolink&600 |}}

2. Add it on your settings:

{{ :socialnet:snh-oasis_invite.png?nolink&600 |}}

3. Your PUB (and others in the [[https://en.wikipedia.org/wiki/Multiverse|Multiverse]]) will begin to be listed, automatically:

{{ :socialnet:snh-federated-networks.png?nolink&600 |}}
==== Finding inhabitants ====

 * **Local network **:

Peers constantly broadcast [[https://en.wikipedia.org/wiki/User_Datagram_Protocol|UDP packets]] on their local network (LAN/WAN) advertising their presence. Therefore, if you share local connection with other inhabitants (for example, via [[https://en.wikipedia.org/wiki/Wi-Fi|Wi-Fi]]), these automatically appear on your pairs connection list.

{{ :socialnet:snh-peer-conns.png?nolink&600 |}}

 * **Internet (using a PUB)**:

1. Join a PUB (where the other inhabitant is present):

{{ :socialnet:snh-oasis_invite-join.png?nolink&600 |}}

2. Find the __Public ID__ of the inhabitant:

{{ :socialnet:snh-inhabitant-publicid.png?nolink&600 |}}

3. Search for it:

{{ :socialnet:snh-inhabitant-search.png?nolink&600 |}}

4. Start to support:

{{ :socialnet:snh-inhabitant-support.png?nolink&600 |}}