Skip to content

Commit

Permalink
Merge pull request #15 from okybaca/fullinstall
Browse files Browse the repository at this point in the history
formatted, renamed and added a link to index
  • Loading branch information
okybaca authored May 28, 2024
2 parents 4201abd + 2d9c0db commit 6e95bfc
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 10 deletions.
1 change: 1 addition & 0 deletions docs/docs.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@
* [Headless - YaCy on a Remote Server](installation/headless.md)
* [Shrink Debian by removing all graphical features to turn it into a headless server](installation/shrink.md)
* [Set a static IP to a debian server](installation/staticip.md)
* [Unix full installation guide](installation/unix-fullinstall.md) - with systemd or runit, nginx, let's encrypt

## Operation
* [Setting the ranking rules](operation/ranking.md)
Expand Down
Original file line number Diff line number Diff line change
@@ -1,39 +1,52 @@
# Full YaCy installation guide
##### (systemd or runit, nginx, let's encrypt)
# Unix full installation guide
(with systemd or runit, nginx, let's encrypt)

## Prerequisites
- Any UNIX-like system which has Nginx, Certbot and Wget in its repos (assuming your distribution is Debian, but actually you can install it even on StaLI.

- Any UNIX-like system which has Nginx, Certbot and Wget in its repos
(assuming your distribution is Debian, packages are installed using `apt`,
but actually you can install it even on StaLI).

- A domain name
- Systemd or Runit-powered UNIX-like system (for using on Runit system, see this: https://aur.archlinux.org/packages/yacy-runit)
- `also, if anyone reading it has some free time, please write services and instructions for their installation for sysvinit, openrc, dinit, etc...`

- Systemd or Runit-powered UNIX-like system (for using on Runit system, see
this: https://aur.archlinux.org/packages/yacy-runit)

- _also, if anyone reading it has some free time, please write services and
instructions for their installation for sysvinit, openrc, dinit, etc..._

## Installation
#### Note: `#` before the command means running as root.
_Note: `#` before the command means running as root._

**1.** Install needed packages:
```
# apt install nginx certbot python3-certbot-nginx wget openjdk-17-jdk-headless
```

**2.** Create a user needed for running YaCy
```
# useradd --system yacydm -m -d /home/yacy
# useradd --system yacyadm -m -d /home/yacy
# useradd --system yacy -m -d /home/yacy
```

**3.** Download, unpack and fix permissions for YaCy\*, please replace download link with new one **for *"Linux"*** located [here](https://yacy.net/download_installation/#download)
#### `$` here means running as user created later, not your own user.

_`$` here means running as user created later, not your own user._

```
# su -l yacy
$ wget https://release.yacy.net/yacy_latest.tar.gz
$ tar -xf yacy_v1.930_202404051704_de941c6fe.tar.gz -C ..
$ exit
# chown -R yacydm:yacydm /home/yacy/
# chown -R yacyadm:yacyadm /home/yacy/
# chown -R yacy:yacy /home/yacy/DATA/
```

**4.** Install systemd service (runit instructions are missing, so if anyone write it, I would be grateful. Write by editing this page on GitHub.)
**4.** Install systemd service (runit instructions are missing, so if anyone
write it, I would be grateful. Write by editing this page on GitHub.)

```
# cat > yacy.service << EOF
[Unit]
Expand Down

0 comments on commit 6e95bfc

Please sign in to comment.