View Source Building eturnal From Source
- Erlang/OTP (21.0 or newer).
- LibYAML (0.1.4 or newer).
- OpenSSL (1.0.0 or newer).
- GCC (other C compilers might work as well).
Note that you need the development headers of the libraries as well. Linux
distributions often put those into separate
*-devel packages. For
example, on DEB-based distributions you'd typically install
libssl-dev, on RPM-based distributions you'll probably need
Note: If you build directly from the Git repository rather than using the official source tarball, you must download Rebar3 and make it executable (
chmod +x rebar3), first. On Erlang/OTP versions prior to 24.x, you need an older Rebar3 version (3.15.x on Erlang/OTP 21.x, otherwise 3.16.x).
curl https://eturnal.net/eturnal-1.12.0.tar.gz | tar -C /tmp -xzf - cd /tmp/eturnal-1.12.0 ./rebar3 as prod tar
This generates the archive file
The default installation prefix is set to
/opt/eturnal, and it's assumed the
server will be executed by a user named
eturnal. To change these defaults,
edit the build.config file or override the settings using environment
variables (of the same name, but upper-case), re-run
./rebar3 as prod tar, and
adapt the following installation instructions accordingly.
To stop the server, enter
q(). (including the trailing dot).
You'll need root privileges for the following commands. Therefore, call
sudo -i, first.
Create a user for running eturnal. This step is of course only required if you're installing eturnal for the first time:
useradd -r -m -d /opt/eturnal eturnal
Otherwise, create a backup of the old installation, first:
tar -czf /opt/eturnal-$(date '+%F').tar.gz /opt/eturnal
Extract the archive generated above:
cd /opt/eturnal tar -xzf /tmp/eturnal-1.12.0/_build/prod/rel/eturnal/eturnal-1.12.0.tar.gz chown eturnal /opt/eturnal/etc/eturnal.yml
cp -p -i /opt/eturnal/etc/eturnal.yml /etc/
Start the systemd service:
cp /opt/eturnal/etc/systemd/system/eturnal.service /etc/systemd/system/ systemctl daemon-reload systemctl --now enable eturnal