This repository has been archived on 2022-10-07. You can view files and clone it, but cannot push or open issues or pull requests.
skynet-webportal/setup-scripts/README.md

82 lines
2.9 KiB
Markdown
Raw Normal View History

2020-01-30 18:39:56 +00:00
# Skynet Portal Setup Scripts
This directory contains a setup guide and scripts that will install and
configure some basic requirements for running a Skynet Portal. The assumption is
that we are working with a Debian Buster Minimal system or similar.
## Initial Setup
(Assumes we are logged in as root on a fresh installation of Debian)
You may want to fork this repository and add your ssh pubkey to
`authorized_keys` and optionally edit the `tmux` and `bash` configurations.
0. SSH in a freshly installed Debian machine.
2020-01-30 18:39:56 +00:00
1. `apt-get update && apt-get install sudo`
2. `adduser user`
3. `usermod -a -G sudo user`
4. Quit the ssh session.
You a can now ssh into your machine as the user `user`.
5. On your local machine: `ssh-copy-id user@ip-addr`
6. On your local machine: `ssh user@ip-addr`
7. Now logged in as `user`: `sudo apt-get install git`
2020-01-30 18:39:56 +00:00
8. `git clone https://github.com/NebulousLabs/skynet-webportal`
2020-01-31 19:10:21 +00:00
9. `cd skynet-webportal/setup-scripts`
2020-02-18 16:04:57 +00:00
10. `./setup.sh`
11. Once DNS records are set you can run: `./letsencrypt-setup.sh`
12. This should edit your nginx configuration for you. If not, you should check
2020-02-06 17:06:44 +00:00
that keys were created by letsencrypt in `/etc/letsencrypt/live/` and add
the following lines into your nginx configuration. Make sure to replace
`YOUR-DOMAIN` with your domain name.
```
ssl_certificate /etc/letsencrypt/live/YOUR-DOMAIN/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/YOUR-DOMAIN/privkey.pem;
```
2020-02-18 16:04:57 +00:00
13. Finally make sure to check your nginx conf and reload nginx:
2020-02-06 17:06:44 +00:00
`sudo nginx -t`
`sudo systemctl reload nginx`
2020-01-31 21:58:30 +00:00
## Running siad
2020-01-31 21:58:30 +00:00
NOTE: You must be running `siad` and `siac` by building from a version at least
as recent as `v1.4.3`.
2020-01-31 21:58:30 +00:00
You still need to setup `siad` for the backend to be complete.
1. `cd ~/; mkdir siad`
2. `nohup siad &>/dev/null &`
This will start syncing `siad` in the background.
## Portal Setup
2020-01-31 21:58:30 +00:00
When `siad` is done syncing, create a new wallet and unlock the wallet.
Then set an allowance (`siac renter setallowance`), with the suggested values
below:
- 10 KS (keep 25 KS in your wallet)
- default period
- default number of hosts
- 8 week renewal time
- 500 GB expected storage
- 500 GB expected upload
- 5 TB expected download
- default redundancy
Once your allowance is set you need to set your node to be a viewnode with the
following command:
`siac renter setallowance --payment-contract-initial-funding 10SC`
2020-01-31 21:58:30 +00:00
Now your node will begin making 10 contracts per block with many hosts so it can
potentially view the whole network's files.
## Running the Portal
`cd` into the parent directory and run `yarn` to build dependencies.
2020-02-18 16:04:57 +00:00
Skynet webportal consists of a client package and api package:
2020-02-18 16:05:20 +00:00
2020-02-18 16:04:57 +00:00
- run `yarn build:client` to build the client package - it will be picket up by nginx automatically
- run `pm2 start pm2.json` to start the api service (we recommend https://pm2.keymetrics.io/ for process management)
If you don't want to use pm2, you can call `yarn start:server` directly.