Building Atheme

  Before we begin building Atheme, let's install some prerequisite dependencies.

apt install pkg-config build-essential gettext git wget xz-utils

Download Atheme to the server we will be hosting from. As of the writing of this guide Atheme release version v7.2.10-r2 will be used in the following examples, however you should be fine with any newer release. You can locate the latest release from the Atheme GitHub repository.[1]

Make sure to downlow the archive file ending in ".tar.xz". Once downloaded, extract the contents and move into the extracted atheme directory.

tar -xf atheme-v7.2.10-r2.tar.xz
cd atheme-v7.2.10-r2/

We can now begin with building Atheme. Run the ./configure script first. It will run through a check to detect local system dependencies. If it comes back with an error for missing dependencies, you will have to search for a package containing the requisite dependency to install.

You should specify an installation location for Atheme. By default running “make install” will install Atheme in “/root/atheme/”. I recommend installing in “/usr/local/atheme/”. This can be specified when running the configure script. It's also easier to remove in the future since everything would be installed in that directory.
One more thing to note; when building Atheme, the location it was configured and installed for at build time cannot be changed. Moving the Atheme files to a different directory on the file-system will result in library file path location errors. If you need to move Atheme to a different directory, then you should re-build with the installation location specified in advance.

./configure --prefix=/usr/local/atheme/
make install

If you followed the previous step for specifying an installation location for Atheme, then you can locate the Atheme files in the following directories:

  • /usr/local/atheme/bin/atheme-services: executable server
  • /usr/local/atheme/etc/atheme.conf.example: sample configuration
  • /usr/local/atheme/etc/services.db: Atheme database file (generated on first launch)




[Return to top]



Last modified date: 2021-01-16