Running the server
The epic server is a node in the network that validates, propagates, and sometimes produces new blocks (for the latter, you need a miner), which is basically a collection of processed transactions. In this section, we explain how to install and setup your epic server.
This will guide you to install the Epic server on each OS:
The Epic server installation on windows is quite simple:
- Download the latest version of the epic server for windows here.
- The binary for Windows is
epic-<version>-win.zip
- Unpack the zip file to a convenient location such as C:\Program Files\Epic
To install the Epic server on Linux, follow this steps
This requirements are necessary to run the epic server on Linux:
- libncurses5
- libncursesw5
- zlib1g
- openssl
You can run this command to install them:
sudo apt install libncurses5 libncursesw5 zlib1g openssl
Before installing the epic server or other components (wallet, miner), we need to install the libRandomX dependency. The following steps explain how to install this dependency:
- Download the latest version of the librandomx package here.
- In the terminal, navigate to the directory where you downloaded the .deb file and execute the following command changing the argument <your-librandomX.deb> to the name of your downloaded file:
sudo dpkg -i <your-librandomX.deb>The best way to install the epic server on Linux is by using the deb installer. Although the binaries are also available on our download page. To install the deb, you can use this steps:
- Download the latest version of the epic package here.
- On Linux we can use the deb installer with name
epic-<version>-linux-deb.tar.gz
- Go to the downloaded file and unpack the tar file and install the binary with:
tar -xf epic-<version>-linux-deb.tar.gz
cd epic
sudo dpkg -i <your-epic-server.deb>After you finished the installation, you can run it by executing the following command in the terminal:
For Linux
epic
For Windows
epic.exe
If you are running the epic server for the first time, it will use its default configuration. If you want to save all epic server data in a custom directory check the section Configuring a Custom Directory.
By default the epic server will run in Text-User-Interface mode (TUI), and you should see a screen like this:
Quit the server then download the bootstrap file with latest blockchain from here https://bootstrap.epic.tech/bootstrap.zip and place in the .epic/main folder then delete the chain_data folder and unzip to (re)create the chain_data folder.
Restart the server and allow your Epic node to synchronize to the latest block, which will take a few minutes. “Header Chain Height” and “Chain Height” will match when fully synchronized.
With the server running you can move to configure your epic wallet.
More information on how to customize your Epic server
By default, the epic server keeps all of its configuration files and data in the ~/.epic/main for Linux/macOS or C:/Users/<YOUR_USERNAME>/.epic/main for Windows. The main server configuration file can be found in the file epic-server.toml. This file is fully documented and contains many configuration options for your Epic server. Leaving these values at their defaults should work for most people who simply want to run a node.
You can also keep Epic’s data and configuration files in a custom directory. In the terminal, navigate to the directory in which you want Epic to store its files and run:
For Linux
epic server config
For windows
epic.exe server config
This will create an epic-server.toml file in the current directory that is configured to place its data files in the same directory. The epic command will always check the current directory for an epic-server.toml file, and if one is found it will use it instead of ~/.epic/main for Linux/macOS or C:/Users/<YOUR_USERNAME>/.epic/main for Windows. Therefore, we always have to navigate to the custom directory before running the epic server.
