mirror of https://github.com/ethereum/go-ethereum
docs: major overhaul (#19395)
parent
6f029479b2
commit
1122480aa3
@ -1,2 +1 @@ |
||||
{% capture root %}{% if page.root %}{{ page.root }}{% else %}{{ site.default_root }}{% endif %}{% endcapture %} |
||||
{{ include.url | remove: ".html" | prepend: root | replace: '//', '/' }} |
||||
{% if page.root %}{% assign root=page.root %}{% else %}{% assign root=site.default_root %}{% endif %}{{ include.url | remove: ".html" | prepend: root | replace: '//', '/' }} |
||||
|
@ -1,48 +0,0 @@ |
||||
--- |
||||
title: Installation instructions for Ubuntu |
||||
--- |
||||
## Installing from PPA |
||||
|
||||
```shell |
||||
sudo apt-get install software-properties-common |
||||
sudo add-apt-repository -y ppa:ethereum/ethereum |
||||
sudo apt-get update |
||||
sudo apt-get install ethereum |
||||
``` |
||||
|
||||
If you want to stay on the bleeding edge, install the `ethereum-unstable` package instead. |
||||
|
||||
After installing, run `geth account new` to create an account on your node. |
||||
|
||||
You should now be able to run `geth` and connect to the network. |
||||
|
||||
Make sure to check the different options and commands with `geth --help` |
||||
|
||||
You can alternatively install only the `geth` CLI with `apt-get install geth` if you don't want to install the other utilities (`bootnode`, `evm`, `disasm`, `rlpdump`, `ethtest`). |
||||
|
||||
## Building from source |
||||
|
||||
### Building Geth (command line client) |
||||
|
||||
Clone the repository to a directory of your choosing: |
||||
|
||||
```shell |
||||
git clone https://github.com/ethereum/go-ethereum |
||||
``` |
||||
Install latest distribution of Go (v1.12.1) if you don't have it already: |
||||
|
||||
[See instructions](Installing-Go#ubuntu-1404) |
||||
|
||||
Building `geth` requires Go and C compilers to be installed: |
||||
|
||||
```shell |
||||
sudo apt-get install -y build-essential golang |
||||
``` |
||||
|
||||
Finally, build the `geth` program using the following command. |
||||
```shell |
||||
cd go-ethereum |
||||
make geth |
||||
``` |
||||
|
||||
You can now run `build/bin/geth` to start your node. |
@ -1,66 +0,0 @@ |
||||
--- |
||||
title: Installation instructions for Windows |
||||
--- |
||||
# Binaries |
||||
|
||||
## Download stable binaries |
||||
|
||||
All versions of Geth are built and available for download at https://geth.ethereum.org/downloads/. |
||||
|
||||
The download page provides an installer as well as a zip file. The installer puts geth into your |
||||
PATH automatically. The zip file contains the command .exe files and can be used without installing. |
||||
|
||||
1. Download zip file |
||||
1. Extract geth.exe from zip |
||||
1. Open a command prompt |
||||
1. chdir <path to geth.exe> |
||||
1. open geth.exe |
||||
|
||||
# Source |
||||
|
||||
## Compiling geth with tools from chocolatey |
||||
|
||||
The Chocolatey package manager provides an easy way to get |
||||
the required build tools installed. If you don't have chocolatey yet, |
||||
follow the instructions on https://chocolatey.org to install it first. |
||||
|
||||
Then open an Administrator command prompt and install the build tools |
||||
we need: |
||||
|
||||
```text |
||||
C:\Windows\system32> choco install git |
||||
C:\Windows\system32> choco install golang |
||||
C:\Windows\system32> choco install mingw |
||||
``` |
||||
|
||||
Installing these packages will set up the `Path` environment variable. |
||||
Open a new command prompt to get the new `Path`. The following steps don't |
||||
need Administrator privileges. |
||||
|
||||
Please ensure that the installed Go version is 1.7 (or any later version). |
||||
|
||||
First we'll create and set up a Go workspace directory layout, |
||||
then clone the source. |
||||
|
||||
***OBS*** If, during the commands below, you get the following message: |
||||
``` |
||||
WARNING: The data being saved is truncated to 1024 characters. |
||||
``` |
||||
Then that means that the `setx` command will fail, and proceeding will truncate the `Path`/`GOPATH`. If this happens, it's better to abort, and try to make some more room in `Path` before trying again. |
||||
|
||||
```text |
||||
C:\Users\xxx> set "GOPATH=%USERPROFILE%" |
||||
C:\Users\xxx> set "Path=%USERPROFILE%\bin;%Path%" |
||||
C:\Users\xxx> setx GOPATH "%GOPATH%" |
||||
C:\Users\xxx> setx Path "%Path%" |
||||
C:\Users\xxx> mkdir src\github.com\ethereum |
||||
C:\Users\xxx> git clone https://github.com/ethereum/go-ethereum src\github.com\ethereum\go-ethereum |
||||
C:\Users\xxx> cd src\github.com\ethereum\go-ethereum |
||||
C:\Users\xxx> go get -u -v golang.org/x/net/context |
||||
``` |
||||
|
||||
Finally, the command to compile geth is: |
||||
|
||||
```text |
||||
C:\Users\xxx\src\github.com\ethereum\go-ethereum> go install -v ./cmd/... |
||||
``` |
Loading…
Reference in new issue