# Setup Feed Guide

*Disclaimer: These instructions are made for Ubuntu 20.04. The commands may not match 100% on other distros, nor is there any guarantee that it will work. Avoid using containerization software like Docker if possible as these cause networking issues.*

# Set Up A New VPS

Please create a fresh VPS and do not attempt to update your existing VPS. Please also don't wipe the VPS running your current Feed because we need to run both networks in parallel to ensure a smooth transition. If this is not possible for you due to unique infra setups like running a home server please reach out to @marcandu on Keybase for further guidance.

Hardware requirements:
- 4 GB ram
- 4 vCPU
- 120 GB storage

**Login to VPS as root:**
`ssh root@<PEER_IP>`

**Patch system:**
`apt-get update && apt-get upgrade -y`

**Create a new user:**

adduser <USER>
usermod -aG sudo <USER>

*do NOT make your username contain the word omnia!*

Two-factor authentication is strongly recommended. Here are some options:
- Google Authenticator: https://tutorials.ubuntu.com/tutorial/configure-ssh-2fa
- Yubikey via OpenPGP: https://developers.yubico.com/PGP/SSH_authentication/

**Sync ssh permissions to new user:**
`rsync --archive --chown=<USER>:<USER> ~/.ssh /home/<USER>`

**Ensure .ssh permissions are set correctly**

chmod 700 /home/<USER>/.ssh
chmod 644 /home/<USER>/.ssh/authorized_keys

**Save login to Env on Workstation**
**Logout of VPS**
`logout`

**Append to .profile configuration on your workstation**

echo 'export MYFEED="<USER>@<PEER_IP>" ' >>~/.profile
source ~/.profile

**Login to VPS as user**
`ssh $MYFEED`

# Transfer Ethereum Keys

You will need to use the exact same keys on your new Feed as your previous Feed. Keep in mind your Feeds Ethereum keys are extremely sensitive. If anyone were to obtain it, they could launch an Oracle attack impersonating your Feed. If you don't know the location of your keys you can do `cat /etc/omnia.conf` and get the path from the ethereum.keystore and ethereum.password fields.

YOU SHOULD NOT RE-USE THE SAME SSB KEY SECRET OR GOSSIP.JSON FILE

New node
`mkdir ~/keys`

From your existing node:

`scp keystore.json <USER>@<NEWVPS>:keys/`
`scp password.txt <USER>@<NEWVPS>:keys/`

# Install Feed
**Install Nix**

curl -L https://nixos.org/nix/install | sh
. /home/<USER>/.nix-profile/etc/profile.d/nix.sh

**Configure Feed Environment**

vim ~/caps.json

**Paste the following snippet into caps config and save the file:**

<ask for the caps configuration>

**Install Omnia and Dependencies**
`nix-env -i --verbose -f https://github.com/chronicleprotocol/oracles/tarball/stable`

Go make a coffee, this will take some time

**Configure Gofer, Spire, Scuttlebot and Omnia**
`install-omnia feed --ssb-caps ~/caps.json --ssb-external <your external ip here> --eth-rpc <https://node1[:port]/path> --eth-rpc <https://node2[:port]/path> --eth-rpc <https://node3[:port]/path>`

**Configure Omnia Config File**

*install-omnia will have copied the omnia configuration file to /etc/omnia.conf
Three fields will need to be changed ethereum.(from, keystore, and password)*

`sudo vim /etc/omnia.conf`

These MUST be the same keys you use on your current Feed.

*Replace `ethereum.from` with your ethereum public key*
*Replace `ethereum.keystore` with the path to the directory containing your keystore*
*Replace `ethereum.password` with the path to the file containing the password to unlock your keystore*

**Set Scuttlebot and Omnia as systemd services and schedule to run on system boot**

sudo systemctl daemon-reload
sudo systemctl enable --now ssb-server
sudo systemctl enable --now splitter-agent.service
sudo systemctl enable --now gofer-agent
sudo systemctl enable --now spire-agent
sudo systemctl enable --now omnia

**[fyi] To stop running Omnia and Scuttlebot**

sudo systemctl stop ssb-server
sudo systemctl stop omnia

**[fyi] To stop Omnia and Scuttlebot from starting on system boot**

sudo systemctl disable --now ssb-server
sudo systemctl disable --now omnia

# Logging and Monitoring

**Check that gofer is functionnal**

gofer -c /etc/gofer.conf  prices WSTETH/USD --format=trace

_note: if you get the error `not enough sources to calculate median`, wait two minutes and try again_

**Check Status of Omnia and Scuttlebot**

sudo systemctl status ssb-server
sudo systemctl status omnia

**Check Scuttlebot logs**
`sudo journalctl -feu ssb-server`

**Check Omnia logs**
`sudo journalctl -feu omnia`

# Verify Configuration
**Verify that ssb-server is running on ports 8007 and 8988.**
If these ports are not correct, your Feed will not function correctly!
`sudo lsof -i -P -n | grep LISTEN | grep ssb-serve`

# Generate Invite Codes

Generate an invite code with 100 users and send it to @marcandu on Keybase. They will then post the invite code on your behalf on the keybase channels, which will help protecting your privacy.

`ssb-server invite.create 100`

**Accept invite**

As you see invites posted in the Keybase channel please be sure to accept them by doing the following:

`ssb-server invite.accept “invite_code_here”`

If you get an error, this usually means the other peer already accepted your invite.