This guide covers how to install rAthena on Debian 10. For earlier versions of Debian you may need to alter the list of required packages. Older versions will not be covered in this guide.
Code that you should run in your console/SSH application is
written like this.
This guide covers the installation via CLI and does not include instructions for installing a desktop environment for use with a VNC server.
- A basic understanding of Linux based Operating Systems.
- A basic understanding of the SSH tool Putty.
- A basic understanding of MySQL (or RDBMS in general).
- A basic understanding of when the root system user should be used, and when you should use a standard user shell.
- A basic understanding that "if at first you don't succeed, search the forums" will be your saving-grace in the event of errors.
You should ensure that your system is up-to-date by first:
We need the following applications to compile rAthena on Debian 10:
If you don't feel comfortable editing files in Vim, you should install nano:
For the installation instructions of MySQL, please see the relevant installation page.
The Code Repository¶
rAthena uses git for revision control, and hosts the git repository on Github.
You can obtain the latest version of rAthena by typing the following command. This will place rAthena in a folder called rAthena in your home directory, but you are free to change it to whatever you like:
To pull the latest updates for rAthena you can do the following:
Compile The Code¶
There are several steps you will need to do now in order to run rAthena. You first need to run the "configure script" to ensure everything is working as it should, and to build necessary make-files.
The next command is not essential every time you compile, but it helps to ensure caches are removed when compiling.
And then finally, we're going to build the server's code.
Potentially, you may need to
chmod your server binaries to make them "executable".
Recompile The Code¶
Recompiling is the same as compiling. You can throw the code into a one-liner, if you like.
The provided method of running rAthena will work perfectly fine, but this author's personal preference is shown below as an alternative method.
Use the following commands
If you receive an error similar to the following:
You can install dos2unix with
apt-get install dos2unix and then run
You will now be able to use
./athena-start start after
chmod a+x athena-start.
First, create the sessions:
Then you can connect to each one individually like so:
cdto your rAthena folder and start the login-server, e.g.
cd ~/rAthena && ./login-server. This should now start the login-server. To detach from the session while keeping the login-server running, you will need to hold down the
Ctrlkey on your keyboard and then press the
Dkeys at the same time. Then, do the same to the other servers. If you want to terminate any of your servers, you will need to resume the session (
-r) and then
To make sure your sessions are still running, you can
screen -ls which will output something similar to:
If you've just started your servers and get some errors, don't worry, it's because you haven't configured them yet.
We have a handy guide here that will talk you through what you need to change in order to get your servers up and running successfully.