Merge branch 'update-readme'
This commit is contained in:
commit
53515f14ab
1 changed files with 41 additions and 17 deletions
58
README.md
58
README.md
|
@ -6,15 +6,14 @@
|
||||||
|
|
||||||
[по-русски](README-ru.md) | [em português](README-ptbr.md) | [简体中文](README-zh-cn.md)
|
[по-русски](README-ru.md) | [em português](README-ptbr.md) | [简体中文](README-zh-cn.md)
|
||||||
|
|
||||||
zeronet-conservancy is a fork/continuation of [ZeroNet](https://github.com/HelloZeroNet/ZeroNet) project
|
`zeronet-conservancy` is a fork/continuation of [ZeroNet](https://github.com/HelloZeroNet/ZeroNet) project
|
||||||
(that has been abandoned by its creator) that is dedicated to sustaining existing p2p network and developing
|
(that has been abandoned by its creator) that is dedicated to sustaining existing p2p network and developing
|
||||||
its values of decentralization and freedom, while gradually switching to a better designed network
|
its values of decentralization and freedom, while gradually switching to a better designed network
|
||||||
|
|
||||||
## No active maintainer warning
|
## No active maintainer warning
|
||||||
|
|
||||||
This fork was created and maintained by @caryoscelus, but due to vanishing interest and in order to avoid having
|
This fork was created and maintained by @caryoscelus, but due to vanishing interest and in order to avoid having
|
||||||
another one-person project, they stepped down. This means there currently is no active maintainer (you're are
|
another one-person project, the development is limitted.
|
||||||
welcome to become one!), however some development might still happen.
|
|
||||||
|
|
||||||
## Why fork?
|
## Why fork?
|
||||||
|
|
||||||
|
@ -75,21 +74,15 @@ Following links relate to original ZeroNet:
|
||||||
|
|
||||||
### Install from your distribution repository
|
### Install from your distribution repository
|
||||||
|
|
||||||
- NixOS: https://search.nixos.org/packages?channel=22.05&show=zeronet-conservancy&type=packages&query=zeronet-conservancy (and see below)
|
- NixOS: [zeronet-conservancy packages search](https://search.nixos.org/packages?from=0&size=50&sort=relevance&type=packages&query=zeronet-conservancy) (and see below)
|
||||||
- ArchLinux: [latest release](https://aur.archlinux.org/packages/zeronet-conservancy), [fresh git version](https://aur.archlinux.org/packages/zeronet-conservancy-git)
|
- ArchLinux: [latest release](https://aur.archlinux.org/packages/zeronet-conservancy), [fresh git version](https://aur.archlinux.org/packages/zeronet-conservancy-git)
|
||||||
|
|
||||||
### Install from Nix package manager (Linux or MacOS)
|
### Install from Nix package manager (Linux or MacOS)
|
||||||
|
|
||||||
```
|
- install & configure nix package manager (if needed)
|
||||||
# install & configure nix package manager
|
- `nix-env -iA nixpkgs.zeronet-conservancy`
|
||||||
nix-env -iA nixpkgs.zeronet-conservancy
|
|
||||||
```
|
|
||||||
|
|
||||||
or
|
or add `zeronet-conservancy` to your system configuration if you're on NixOS
|
||||||
|
|
||||||
`nix-env -iA nixos.zeronet-conservancy`
|
|
||||||
|
|
||||||
if you're on NixOS
|
|
||||||
|
|
||||||
(thanks @fgaz for making & maintaining the package)
|
(thanks @fgaz for making & maintaining the package)
|
||||||
|
|
||||||
|
@ -100,11 +93,25 @@ if you're on NixOS
|
||||||
##### Generic unix-like (including mac os x)
|
##### Generic unix-like (including mac os x)
|
||||||
|
|
||||||
Install autoconf and other basic development tools, python3 and pip, then proceed to "building python dependencies"
|
Install autoconf and other basic development tools, python3 and pip, then proceed to "building python dependencies"
|
||||||
|
(if running fails due to missing dependency, please report it/make pull request to fix dependency list)
|
||||||
|
|
||||||
##### Apt-based (debian, ubuntu, etc)
|
##### Apt-based (debian, ubuntu, etc)
|
||||||
- `sudo apt update`
|
- `sudo apt update`
|
||||||
- `sudo apt install pkg-config libffi-dev python3-pip python3-venv python3-dev build-essential`
|
- `sudo apt install pkg-config libffi-dev python3-pip python3-venv python3-dev build-essential`
|
||||||
|
|
||||||
|
##### Red Hat and Fedora based
|
||||||
|
- `yum install epel-release -y 2>/dev/null`
|
||||||
|
- `yum install git python3 python3-wheel`
|
||||||
|
|
||||||
|
##### Fedora based dandified
|
||||||
|
- `sudo dnf install git python3-pip python3-wheel -y`
|
||||||
|
|
||||||
|
##### openSUSE
|
||||||
|
- `sudo zypper install python3-pip python3-setuptools python3-wheel`
|
||||||
|
|
||||||
|
##### Arch and Manjaro based
|
||||||
|
- `sudo pacman -S git python-pip -v --no-confirm`
|
||||||
|
|
||||||
##### Android/Termux
|
##### Android/Termux
|
||||||
- install [Termux](https://termux.com/) (in Termux you can install packages via `pkg install <package-names>`)
|
- install [Termux](https://termux.com/) (in Termux you can install packages via `pkg install <package-names>`)
|
||||||
- `pkg update`
|
- `pkg update`
|
||||||
|
@ -114,7 +121,7 @@ Install autoconf and other basic development tools, python3 and pip, then procee
|
||||||
- (optional) `pkg install tor`
|
- (optional) `pkg install tor`
|
||||||
- (optional) run tor via `tor --ControlPort 9051 --CookieAuthentication 1` command (you can then open new session by swiping to the right)
|
- (optional) run tor via `tor --ControlPort 9051 --CookieAuthentication 1` command (you can then open new session by swiping to the right)
|
||||||
|
|
||||||
#### Building python dependencies venv & running
|
#### Building python dependencies, venv & running
|
||||||
- clone this repo (NOTE: on Android/Termux you should clone it into "home" folder of Termux, because virtual environment cannot live in `storage/`)
|
- clone this repo (NOTE: on Android/Termux you should clone it into "home" folder of Termux, because virtual environment cannot live in `storage/`)
|
||||||
- `python3 -m venv venv` (make python virtual environment, the last `venv` is just a name, if you use different you should replace it in later commands)
|
- `python3 -m venv venv` (make python virtual environment, the last `venv` is just a name, if you use different you should replace it in later commands)
|
||||||
- `source venv/bin/activate` (activate environment)
|
- `source venv/bin/activate` (activate environment)
|
||||||
|
@ -139,13 +146,30 @@ Install autoconf and other basic development tools, python3 and pip, then procee
|
||||||
- or: `docker compose up -d 0net-tor` for run 0net and tor in one container.
|
- or: `docker compose up -d 0net-tor` for run 0net and tor in one container.
|
||||||
(please check if these instructions are still accurate)
|
(please check if these instructions are still accurate)
|
||||||
|
|
||||||
|
#### Alternative one-liner (by @ssdifnskdjfnsdjk) (installing python dependencies globally)
|
||||||
|
|
||||||
|
Clone Github repository and install required Python modules. First
|
||||||
|
edit zndir path at the begining of the command, to be the path where
|
||||||
|
you want to store `zeronet-conservancy`:
|
||||||
|
|
||||||
|
`zndir="/home/user/myapps/zeronet" ; if [[ ! -d "$zndir" ]]; then git clone --recursive "https://github.com/zeronet-conservancy/zeronet-conservancy.git" "$zndir" && cd "$zndir"||exit; else cd "$zndir";git pull origin master; fi; cd "$zndir" && pip install -r requirements.txt|grep -v "already satisfied"; echo "Try to run: python3 $(pwd)/zeronet.py"`
|
||||||
|
|
||||||
|
(This command can also be used to keep `zeronet-conservancy` up to date)
|
||||||
|
|
||||||
#### Alternative script
|
#### Alternative script
|
||||||
- after installing general dependencies and cloning repo (as above), run `start-venv.sh` which will create a virtual env for you and install python requirements
|
- after installing general dependencies and cloning repo (as above),
|
||||||
|
run `start-venv.sh` which will create a virtual env for you and
|
||||||
|
install python requirements
|
||||||
- more convenience scripts to be added soon
|
- more convenience scripts to be added soon
|
||||||
|
|
||||||
### Building under windows os
|
### (unofficial) Windows OS build
|
||||||
|
|
||||||
(this instruction is work-in-progress, please help us test it and improve it!)
|
Download and extract .zip archive
|
||||||
|
[zeronet-conservancy-0.7.10-unofficial-win64.zip](https://github.com/zeronet-conservancy/zeronet-conservancy/releases/download/v0.7.10/zeronet-conservancy-0.7.10-unofficial-win64.zip)
|
||||||
|
|
||||||
|
### Building under Windows OS
|
||||||
|
|
||||||
|
(These instructions are work-in-progress, please help us test it and improve it!)
|
||||||
|
|
||||||
- install python from https://www.python.org/downloads/
|
- install python from https://www.python.org/downloads/
|
||||||
- install some windows compiler suitable for python , this proved to be the most difficult part for me as non-windows user (see here https://wiki.python.org/moin/WindowsCompilers and i'll link more references later)
|
- install some windows compiler suitable for python , this proved to be the most difficult part for me as non-windows user (see here https://wiki.python.org/moin/WindowsCompilers and i'll link more references later)
|
||||||
|
|
Loading…
Reference in a new issue