> For the complete documentation index, see [llms.txt](https://callisto-network.gitbook.io/callisto-network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://callisto-network.gitbook.io/callisto-network/technologies/tutorials/how-to-run-a-callisto-network-node.md). # How to Run a Callisto Network Node? ![](/files/FU8Zn7GER4cUbgUw50TP) There are 2 options how to run a Callisto Network node. 1. The simpliest way is to download a precompiled binary of of the go-callisto/geth client from github. {% hint style="info" %} {% endhint %} \ After downloading, copy the binary to /usr/local/bin with the name of the binary “geth”.
``` chmod 775 ./geth-linux-amd64 sudo mv ./geth-linux-amd64 /usr/local/bin/geth ``` 2\. Another option is to compile the source code. To do so please follow the steps below.\ \ This is a simple tutorial for compiling the source code of the go-callisto/geth client. What do you need first? A fresh install of the OSes! Let's Go :)
### **Preparation for UBUNTU 18.04** We start this tutorial by preparing Ubuntu 18.04. It is necessary to install Go. #### Installing Go: ``` $ wget https://go.dev/dl/go1.21.1.linux-amd64.tar.gz $ sudo tar -C /usr/local –xzf go1.21.1.linux-amd64.tar.gz $ sudo chown -R root:root ./go $ sudo mv go /usr/local ``` \ Now we will add PATH to the profile, to do this open the ".profile" file. ``` $ sudo nano ~/.profile ``` Add this 2 lines to the end of the ".profile" file. ``` export GOPATH=$HOME/work export PATH=$PATH:/usr/local/go/bin:$GOPATH/bin ``` ![Add PATH to profile](/files/3rdszUC9c9iGIodkibtW) Load the profile with: ``` $ source ~/.profile ``` Install the dependency for compiling. ``` $ sudo apt-get install build-essential ``` ### **Preparation for CentOS** In this step, we will install the dependencies for the Go-Callisto client compilation. ``` $ sudo yum install wget nano git gcc ``` Installing Go: ``` $ wget https://go.dev/dl/go1.21.1.linux-amd64.tar.gz $ sudo tar -C /usr/local –xzf go1.21.1.linux-amd64.tar.gz ``` Now we will add PATH to the profile, to do this open the ".bash\_profile" file. ``` $ sudo nano ~/.bash_profile ``` Add this line to the end of the ".bash\_profile" file. ``` export PATH=$PATH:/usr/local/go/bin ``` Load the profile with: ``` $ source ~/.bash_profile ``` ### **Installing Go-Callisto** Now that Go is installed, the next step is to install Go-Callisto/Geth client. The command is same under Ubuntu or CentOS. Clone the repo. ``` $ git clone -b master https://github.com/EthereumCommonwealth/go-callisto.git $ cd go-callisto ``` Make the go-callisto/geth client. ``` $ make geth $ sudo cp build/bin/geth /usr/local/bin/ ``` \ Check Go-Callisto/Geth client version. ``` $ geth version ``` ![Example of Geth Version output.](/files/P3LvHsoEYbCh6AARflH5) ### **Running The Node** \ To run Go-Callisto/Geth client type the following command: ``` $ geth ``` \ Depending on what you intend to do with the node itself, you have several options. Do you plan to make an Explorer? A mining pool? A web wallet? Or perhaps just run a node? All options and their details are listed in the section below. ### Geth Commands List `[root@node-clo-centos bin]# ./geth help` `NAME: geth - the go-ethereum command line interface` `Copyright 2013-2019 The go-ethereum Authors` `USAGE: geth [options] command [command options] [arguments...]` `VERSION: 1.9.15-stable-49bad91e` #### COMMANDS `account` *Manage accounts.* `attach` *Start an interactive JavaScript environment (connect to node).* `console` *Start an interactive JavaScript environment.* `copydb` *Create a local chain from a target chaindata folder.* `dump` *Dump a specific block from storage.* `dumpconfig` *Show configuration values.* `dumpgenesis` *Dumps genesis block JSON configuration to stdout.* `export` *Export blockchain into file.* `export-preimages` *Export the preimage database into an RLP stream.* `import` *Import a blockchain file.* `import-preimages` *Import the preimage database from an RLP stream.* `init` *Bootstrap and initialize a new genesis block.* `inspect` *Inspect the storage size for each type of data in the database.* `js` *Execute the specified JavaScript files.* `license` *Display license information.* `makecache` *Generate ethash verification cache (for testing).* `makedag` *Generate ethash mining DAG (for testing).* `removedb` *Remove blockchain and state databases.* `retesteth` *Launches geth in retesteth mode.* `show-deprecated-flags` *Show flags that have been deprecated.* `version` *Print version numbers.* `wallet` *Manage Ethereum presale wallets.* `help, h` *Shows a list of commands or help for one command.* #### ETHEREUM OPTIONS `--config value` *TOML configuration file.* `--datadir value` *Data directory for the databases and keystore (default: "/home/lumir/.callisto").* `--datadir.ancient value` *Data directory for ancient chain segments (default = inside chaindata).* `--keystore value` *Directory for the keystore (default = inside the datadir).* `--nousb` *Disables monitoring for and managing USB hardware wallets.* `--pcscdpath value` *Path to the smartcard daemon (pcscd) socket file (default: "/run/pcscd/pcscd.comm").* `--networkid value` *Network identifier (integer, 1=Frontier, 3=Ropsten, 4=Rinkeby, 5=Görli) (default: 1).* `--goerli` *Görli network: pre-configured proof-of-authority test network.* `--rinkeby` *Rinkeby network: pre-configured proof-of-authority test network.* `--yolov1` *YOLOv1 network: pre-configured proof-of-authority shortlived test network.* `--ropsten` *Ropsten network: pre-configured proof-of-work test network.* `--syncmode value` *Blockchain sync mode ("fast", "full", or "light") (default: fast)*\ *--exitwhensynced Exits after block synchronisation completes.* `--gcmode value` *Blockchain garbage collection mode ("full", "archive") (default: "full").* `--txlookuplimit value` *Number of recent blocks to maintain transactions index by-hash for (default = index all blocks) (default: 0).* `--ethstats value` *Reporting URL of a ethstats service (nodename:secret\@host:port).* `--identity value` *Custom node name.* `--lightkdf` *Reduce key-derivation RAM & CPU usage at some expense of KDF strength.* `--whitelist value` *Comma separated block number-to-hash mappings to enforce (\=\).* #### LIGHT CLIENT OPTIONS `--light.serve value` *Maximum percentage of time allowed for serving LES requests (multi-threaded processing allows values over 100) (default: 0).* `--light.ingress value` *Incoming bandwidth limit for serving light clients (kilobytes/sec, 0 = unlimited) (default: 0).* `--light.egress value` *Outgoing bandwidth limit for serving light clients (kilobytes/sec, 0 = unlimited) (default: 0).* `--light.maxpeers value` *Maximum number of light clients to serve, or light servers to attach to (default: 100).* `--ulc.servers value` *List of trusted ultra-light servers.* `--ulc.fraction value` *Minimum % of trusted ultra-light servers required to announce a new head (default: 75).* `--ulc.onlyannounce` *Ultra light server sends announcements only.*
#### DEVELOPER CHAIN OPTIONS `--dev` *Ephemeral proof-of-authority network with a pre-funded developer account, mining enabled.* `--dev.period value` *Block period to use in developer mode (0 = mine only if transaction pending) (default: 0).* #### ETHASH OPTIONS `--ethash.cachedir value` *Directory to store the ethash verification caches (default = inside the datadir).* `--ethash.cachesinmem value` *Number of recent ethash caches to keep in memory (16MB each) (default: 2).* `--ethash.cachesondisk value` *Number of recent ethash caches to keep on disk (16MB each) (default: 3).* `--ethash.cacheslockmmap` *Lock memory maps of recent ethash caches.* `--ethash.dagdir value` *Directory to store the ethash mining DAGs (default: "/home/lumir/.ethash").* `--ethash.dagsinmem value` *Number of recent ethash mining DAGs to keep in memory (1+GB each) (default: 1).* `--ethash.dagsondisk value` *Number of recent ethash mining DAGs to keep on disk (1+GB each) (default: 2).* `--ethash.dagslockmmap` *Lock memory maps for recent ethash mining DAGs.*
#### TRANSACTION POOL OPTIONS `--txpool.locals value` *Comma separated accounts to treat as locals (no flush, priority inclusion).* `--txpool.nolocals` *Disables price exemptions for locally submitted transactions.* `--txpool.journal value` *Disk journal for local transaction to survive node restarts (default: "transactions.rlp").* `--txpool.rejournal value` *Time interval to regenerate the local transaction journal (default: 1h0m0s).* `--txpool.pricelimit value` *Minimum gas price limit to enforce for acceptance into the pool (default: 1).* `--txpool.pricebump value` *Price bump percentage to replace an already existing transaction (default: 10).* `--txpool.accountslots value`*Minimum number of executable transaction slots guaranteed per account (default: 16).* `--txpool.globalslots value` *Maximum number of executable transaction slots for all accounts (default: 4096).* `--txpool.accountqueue value`*Maximum number of non-executable transaction slots permitted per account (default: 64).* `--txpool.globalqueue value` *Maximum number of non-executable transaction slots for all accounts (default: 1024).* `--txpool.lifetime value` *Maximum amount of time non-executable transaction are queued (default: 3h0m0s).*
#### PERFORMANCE TUNING OPTIONS `--cache value` *Megabytes of memory allocated to internal caching (default = 4096 mainnet full node, 128 light mode) (default: 1024).* `--cache.database value` *Percentage of cache memory allowance to use for database io (default: 50).* `--cache.trie value` *Percentage of cache memory allowance to use for trie caching (default = 15% full mode, 30% archive mode) (default: 15).* `--cache.gc value` *Percentage of cache memory allowance to use for trie pruning (default = 25% full mode, 0% archive mode) (default: 25).* `--cache.snapshot value` *Percentage of cache memory allowance to use for snapshot caching (default = 10% full mode, 20% archive mode) (default: 10).* `--cache.noprefetch` *Disable heuristic state prefetch during block import (less CPU and disk IO, more time waiting for data).*
#### ACCOUNT OPTIONS `--unlock value` *Comma separated list of accounts to unlock.* `--password value` *Password file to use for non-interactive password input.* `--signer value` *External signer (url or path to ipc file).* `--allow-insecure-unlock` *Allow insecure account unlocking when account-related RPCs are exposed by http.*
#### API AND CONSOLE OPTIONS `--ipcdisable` *Disable the IPC-RPC server.* `--ipcpath value` *Filename for IPC socket/pipe within the datadir (explicit paths escape it).* `--http` *Enable the HTTP-RPC server.* `--http.addr value` *HTTP-RPC server listening interface (default: "localhost").* `--http.port value` *HTTP-RPC server listening port (default: 8545).* `--http.api value` *API's offered over the HTTP-RPC interface.* `--http.corsdomain value` *Comma separated list of domains from which to accept cross origin requests (browser enforced).* `--http.vhosts value` *Comma separated list of virtual hostnames from which to accept requests (server enforced) Accepts '\*' wildcard. (default: "localhost").* `--ws` *Enable the WS-RPC server.* `--ws.addr value` *WS-RPC server listening interface (default: "localhost").* `--ws.port value` *WS-RPC server listening port (default: 8546).* `--ws.api value` *API's offered over the WS-RPC interface.* `--ws.origins value` *Origins from which to accept websockets requests.* `--graphql` *Enable the GraphQL server.* `--graphql.addr value` *GraphQL server listening interface (default: "localhost").* `--graphql.port value` *GraphQL server listening port (default: 8547).* `--graphql.corsdomain value` *Comma separated list of domains from which to accept cross origin requests (browser enforced).* `--graphql.vhosts value` *Comma separated list of virtual hostnames from which to accept requests (server enforced). Accepts '\*' wildcard. (default: "localhost").* `--rpc.gascap value` *Sets a cap on gas that can be used in eth\_call/estimateGas (default: 0).* `--jspath loadScript` *JavaScript root path for loadScript (default: ".").* `--exec value` *Execute JavaScript statement.* `--preload value` *Comma separated list of JavaScript files to preload into the console.*
#### NETWORKING OPTIONS `--bootnodes value` *Comma separated enode URLs for P2P discovery bootstrap.* `--bootnodesv4 value` *Comma separated enode URLs for P2P v4 discovery bootstrap (light server, full nodes) (deprecated, use --bootnodes).* `--bootnodesv5 value` *Comma separated enode URLs for P2P v5 discovery bootstrap (light server, light nodes) (deprecated, use --bootnodes).* `--discovery.dns value` *Sets DNS discovery entry points (use "" to disable DNS).* `--port value` *Network listening port (default: 30303).* `--maxpeers value` *Maximum number of network peers (network disabled if set to 0) (default: 50).* `--maxpendpeers value` *Maximum number of pending connection attempts (defaults used if set to 0) (default: 0).* `--nat value` *NAT port mapping mechanism (any|none|upnp|pmp|extip:\) (default: "any").* `--nodiscover` *Disables the peer discovery mechanism (manual peer addition).* `--v5disc` *Enables the experimental RLPx V5 (Topic Discovery) mechanism.* `--netrestrict value` *Restricts network communication to the given IP networks (CIDR masks).* `--nodekey value` *P2P node key file.* `--nodekeyhex value` *P2P node key as hex (for testing).*
#### MINER OPTIONS `--mine` *Enable mining.* `--miner.threads value` *Number of CPU threads to use for mining (default: 0).* `--miner.notify value` *Comma separated HTTP URL list to notify of new work packages.* `--miner.gasprice value` *Minimum gas price for mining a transaction (default: 10000000000).* `--miner.gastarget value` *Target gas floor for mined blocks (default: 5000000).* `--miner.gaslimit value` *Target gas ceiling for mined blocks (default: 5000000).* `--miner.etherbase value` *Public address for block mining rewards (default = first account)(default: "0").* `--miner.extradata value` *Block extra data set by the miner (default = client version).* `--miner.recommit value` *Time interval to recreate the block being mined (default: 3s).* `--miner.noverify` *Disable remote sealing verification.*
#### GAS PRICE ORACLE OPTIONS `--gpo.blocks value` *Number of recent blocks to check for gas prices (default: 20).* `--gpo.percentile value` *Suggested gas price is the given percentile of a set of recent transaction gas prices (default: 60).*
#### VIRTUAL MACHINE OPTIONS `--vmdebug` *Record information useful for VM and contract debugging.* `--vm.evm value` *External EVM configuration (default = built-in interpreter).* `--vm.ewasm value` *External ewasm configuration (default = built-in interpreter).*
#### LOGGING AND DEBUGGING OPTIONS `--fakepow` *Disables proof-of-work verification.* `--nocompaction` *Disables db compaction after import.* `--verbosity value` *Logging verbosity: 0=silent, 1=error, 2=warn, 3=info, 4=debug, 5=detail (default: 3).* `--vmodule value` *Per-module verbosity: comma-separated list of \=\ (e.g. eth/\*=5,p2p=4).* `--backtrace value` *Request a stack trace at a specific logging statement (e.g. "block.go:271").* `--debug` *Prepends log messages with call-site location (file and line number).* `--pprof` *Enable the pprof HTTP server.* `--pprof.addr value` *pprof HTTP server listening interface (default: "127.0.0.1").* `--pprof.port value` *pprof HTTP server listening port (default: 6060).* `--pprof.memprofilerate value` *Turn on memory profiling with the given rate (default: 524288).* `--pprof.blockprofilerate value` *Turn on block profiling with the given rate (default: 0).* `--pprof.cpuprofile value` *Write CPU profile to the given file.* `--trace value` *Write execution trace to the given file.*
#### METRICS AND STATS OPTIONS `--metrics` *Enable metrics collection and reporting.* `--metrics.expensive` *Enable expensive metrics collection and reporting.* `--metrics.influxdb` *Enable metrics export/push to an external InfluxDB database.* `--metrics.influxdb.endpoint value` *InfluxDB API endpoint to report metrics to (default: "").* `--metrics.influxdb.database value` *InfluxDB database name to push reported metrics to (default: "geth").* `--metrics.influxdb.username value` *Username to authorize access to the database (default: "test").* `--metrics.influxdb.password value` *Password to authorize access to the database (default: "test").* `--metrics.influxdb.tags value` *Comma-separated InfluxDB tags (key/values) attached to all measurements (default: "host=localhost").*
#### WHISPER (EXPERIMENTAL) OPTIONS `--shh` *Enable Whisper.* `--shh.maxmessagesize value` *Max message size accepted (default: 1048576).* `--shh.pow value` *Minimum POW accepted (default: 0.2).* `--shh.restrict-light` *Restrict connection between two whisper light clients.*
#### ALIASED (deprecated) OPTIONS `--rpc` *Enable the HTTP-RPC server (deprecated, use --http).* `--rpcaddr value` *HTTP-RPC server listening interface (deprecated, use --http.addr) (default: "localhost").* `--rpcport value` *HTTP-RPC server listening port (deprecated, use --http.port) (default: 8545).* `--rpccorsdomain value` *Comma separated list of domains from which to accept cross origin requests (browser enforced) (deprecated, use --http.corsdomain).* `--rpcvhosts value` *Comma separated list of virtual hostnames from which to accept requests (server enforced). Accepts '\*' wildcard. (deprecated, use --http.vhosts) (default: "localhost").* `--rpcapi value` *API's offered over the HTTP-RPC interface (deprecated, use --http.api).* `--wsaddr value` *WS-RPC server listening interface (deprecated, use --ws.addr) (default: "localhost").* `--wsport value` *WS-RPC server listening port (deprecated, use --ws.port) (default: 8546).* `--wsorigins value` *Origins from which to accept websockets requests (deprecated, use --ws.origins).* `--wsapi value` *API's offered over the WS-RPC interface (deprecated, use --ws.api).* `--gpoblocks value` *Number of recent blocks to check for gas prices (deprecated, use --gpo.blocks) (default: 20).* `--gpopercentile value` *Suggested gas price is the given percentile of a set of recent transaction gas prices (deprecated, use --gpo.percentile) (default: 60).* `--pprofport value` *pprof HTTP server listening port (deprecated, use --pprof.port) (default: 6060).* `--pprofaddr value` *pprof HTTP server listening interface (deprecated, use --pprof.addr) (default: "127.0.0.1").* `--memprofilerate value` *Turn on memory profiling with the given rate (deprecated, use --pprof.memprofilerate) (default: 524288).* `--blockprofilerate value` *Turn on block profiling with the given rate (deprecated, use --pprof.blockprofilerate) (default: 0).* `--cpuprofile value` *Write CPU profile to the given file (deprecated, use --pprof.cpuprofile).* #### MISC OPTIONS `--snapshot` *Enables snapshot-database mode -- experimental work in progress feature.* `--help, -h` *Show help.*
Copyright 2013-2020 The go-ethereum Authors