github.com/piotrnar/gocoin@v0.0.0-20240512203912-faa0448c5e96/website/gocoin_installation.html (about)

     1  <html>
     2  <head>
     3  <link rel="stylesheet" href="style.css" type="text/css">
     4  </head>
     5  <body>
     6  <h1>Installation</h1>
     7  <h2>System requirements</h2>
     8  
     9  If you only want to use the <b>wallet</b> with the corresponding <b>balio</b> tool,
    10  you can run it on anything that your <b>go</b> compiler can build for.<br>
    11  For instance, it will work on even the oldest Raspberry Pi model A with 256MB of RAM.
    12  <br><br>
    13  
    14  However, in order to run the full node (<b>client</b>), you need a 64-bit OS with a decent amount of RAM.<br>
    15  See the <a href="https://github.com/piotrnar/gocoin/blob/master/README.md#hardware" target="_blank">README.md</a> file
    16  for the current RAM requirement.<br>
    17  <br>
    18  You also need a file system that supports large files (bigger than 4GB) and a decent size of a free space on it.<br>
    19  <br>
    20  Note that you can purge blocks from disk, allowing you to run the node with a limited storage (e.g. 20GB).<br>
    21  See <a href="gocoin_manual_config.html">config file</a> values:
    22  <span class="cfg_name">Memory.MaxDataFileMB</span> and <span class="cfg_name">Memory.DataFilesKeep</span> (set this one to non-zero, e.g. 10)<br>
    23  <br>
    24  The node runs very well on Linux based virtual servers, as long as they have enough RAM.<br>
    25  <!--
    26  Find below a list of example providers. Most of them you can rent per-hour (estimated monthly cost in brackets).<br>
    27  <a target="_blank" href="https://www.scaleway.com/">Scaleway</a>
    28  &bull;
    29  <a target="_blank" href="https://upcloud.com/">UpCloud</a> ($80)
    30  &bull;
    31  <a target="_blank" href="https://www.vultr.com/">Vultr</a> ($80)
    32  &bull;
    33  <a target="_blank" href="https://www.digitalocean.com/">DigitalOcean</a> ($80)
    34  &bull;
    35  <a target="_blank" href="https://linode.com/">linode</a> ($80)
    36  &bull;
    37  <a target="_blank" href="https://aws.amazon.com/">Amazon AWS</a> ($100)
    38  &bull;
    39  <a target="_blank" href="https://cloud.google.com/">Google Cloud</a> ($100)
    40  <br>
    41  <i>Mind that some of the prices above may not include VAT.</i><br>
    42  <br>
    43  -->
    44  To quickly assess a performance of a chosen platform, you can use the benchmark below (lower time = better performance).<br>
    45  <pre>
    46  
    47  	package main
    48  
    49  	import (
    50  		"fmt"
    51  		"math/rand"
    52  		"time"
    53  	)
    54  
    55  	const (
    56  		MAPSIZE = 8
    57  		RECNT   = int(20e6)
    58  	)
    59  
    60  	func main() {
    61  		tm := make(map[[MAPSIZE]byte]bool, RECNT)
    62  		var k [MAPSIZE]byte
    63  		fmt.Println("Plase wait...")
    64  		sta := time.Now()
    65  		for i := 0; i < RECNT; i++ {
    66  			rand.Read(k[:])
    67  			tm[k] = true
    68  		}
    69  		fmt.Printf("All %d records loaded in %s\n", RECNT, time.Now().Sub(sta).String())
    70  	}
    71  
    72  </pre>
    73  <br>
    74  <h2>Build from source</h2>
    75  
    76  You will need <b>git</b> and <b>go</b> commands installed in your system.<br>
    77  <br>
    78  Download the source code from github to a local folder of your choice, e.g. by executing:
    79  <code>git clone https://github.com/piotrnar/gocoin.git</code>
    80  <br>
    81  Then go to <code>gocoin/client/</code> and execute <code>go build</code> there.
    82  Do the same in <code>gocoin/wallet/</code>, to build the wallet. <br>
    83  In order to build <code>balio</code> or some other tool, go to <code>gocoin/tools/</code> and do <code>go build balio.go</code><br>
    84  <br>
    85  
    86  The process is also described in the main <b>README.md</b> file of the github repo
    87  <a target="_blank" href="https://github.com/piotrnar/gocoin">piotrnar/gocoin</a><br>
    88  <br>
    89  
    90  <h2>Binaries</h2>
    91  The binaries (usually not the latest version) for Windows and Linux can be downloaded from
    92  <a target="_blank" href="https://sourceforge.net/projects/gocoin/files/?source=directory">sourceforge.net</a>
    93  </body>
    94  </html>