Setting up a Full Dogeparty Node on Linux
This blog is based on https://dogeparty.net/dogenode/ plus some own experiences. It is easy to follow even for Linux noobs bcs I am one prime example.
1. Hardware requirements:
Memory: 8GB RAM (I am using a server with 32 GB RAM and a processor with 16 kernels and it is really smooth and fast; but I also want to play with the data etc.)
Disk space: 500 GB (I am having 600 GB SSD)
2. Operating system (OS) & Python:
Please note that Ubuntu Linux is the recommended OS. The Dogeparty devs recommend Ubuntu 20.10 64-bit. In my case that was not working smoothly, while 20.04 (the long-term stable release) was doing the trick.
You need a recent Python installation (3.5 or newer), which is usually in place with Ubuntu. You can that check in the console (to open a terminal, you can press Ctrl, Alt and T keys together) by typing
$ python3 -V
(Note the the $ symbol indicates that you type in that line into the console, but without the $ symbol.)
If Python is not installed, then you need to follow these instructions.
3. Create suitable user type
Install as a non-root sudo-er from home directory. Installing from root (like admin for Windows people) cause trouble. I was using this helpful approach.
a) Run the command adduser to create your new user (replace with your „username“)
$ sudo adduser username
b) You will be prompted to enter a password for the new user, Full Name, Room number and phone details. You can press Enter if you don’t want to enter a value. Then, press Y once you get a prompt to confirm the details.
c) Add the new user to the sudo (admin) group
$ sudo usermod -aG sudo username
d) Check whether this was working
First, change user
$ su - username
Second, check whether this user can perform admin tasks
$ sudo dpkg-reconfigure tzdata
4. Update system & install dependencies
Get updates first
$ sudo apt-get update && sudo apt-get upgrade
Install a few commands
$ sudo apt-get -y install git curl coreutils
Install docker and docker-compose (see here for more info):
$ sudo apt-get -y install docker docker-compose
5. Clone Github repository
Clone dogenode repository
$ git clone https://github.com/DogepartyXDP/dogenode.git
Enter cloned directory:
$ cd dogenode
Create a link to directory (honestly I do not fully understand that line...)
$ sudo ln -sf `pwd`/dogenode.py /usr/local/bin/dogenode
6. Build and link the containers
Run the following command to run a full federated node configuration
$ dogenode install full master
(What the fuck is a container? --> A container is a standard unit of software that packages up code and all its dependencies so the application runs quickly and reliably from one computing environment to another. More information here)
7. Check Services
After installation, the services will be automatically started. Depending on your internet connection and your hardware, it may take a day or more to fully synch
(Note that a Dogecoin node alone has more than 360 GB)
To check the status, type
$ dogenode ps
To view (a part of the) logs, use the following command:
dogenode tail <service>
Where <service> may be one the following (or blank to tail all services):
dogeparty (dogeparty-server mainnet)
dogeblock (dogeblock mainnet)
dogecoin (dogecoin mainnet)
Note that you need to stop the log by pressing the Ctrl+C keys.
8. Stopping and restarting containers
To stop the containers affecting all services, type
$ dogenode stop
To restart the containers affecting all services (say after you stopped before), type
$ dogenode restart
For most people not that relevant at the beginning (given that the container starts automatically after installation): To start the containers affecting all services, type
$ dogenode start
9. Updating
To pull the newest software from the git repositories and restart the appropriate daemon, issue the following command:
$ dogenode update
It is rather important (according to the devs) to update your node as soon as possible.
10. Using the node
Last but not least: how do you (and your frens) use your Dogeparty node? It is very simple, just add your IP address into Dogewallet's (desktop app!) settings --> Server settings --> DP host. In my case, I was hosting my DP server at 188.34.163.196 until May 31st, 2022.
