Skip to content

Installation

Before proceeding, ensure that all system requirements are met (supported OS, dependencies, disk space, and permissions).

Create a system user

For security and isolation, LogCraft should run under its own system user and group. On the server where LogCraft is installed, create them with:

bash
groupadd --system logcraft
bash
useradd --system --no-create-home --home-dir /opt/logcraft --shell /usr/sbin/nologin --gid logcraft logcraft

This creates a system user logcraft with no login shell, associated with a group of the same name.

Install LogCraft

First, upload the LogCraft tarball to the target server and connect via SSH.

Then, ensure the tarball has not been altered by verifying its signature:

bash
% sha256sum -c logcraft-platform-25.1-x86_64.tar.gz.sha256
logcraft-platform-25.1-x86_64.tar.gz: OK
%

Continue by extracting its content into /opt:

bash
tar xzf logcraft-platform-25.1-x86_64.tar.gz -C /opt

Next, run the install command to set up LogCraft. The command prompts for the administrator password, if systemd and logrotate should be enabled and basic network information to generate a self-signed certificate.

bash
/opt/logcraft/bin/logcraft install

Administrator Login

To access the Web Interface after installation, use the default administrator email address: admin@localhost.lan and the password set during this step.

The email address and other account properties can later be updated through Global Settings in the Web Interface.

Now, set the ownership of the entire directory to the logcraft user and group.

bash
chown -R logcraft:logcraft /opt/logcraft

Finally, although optional, it’s recommended to add LogCraft’s bin directory to the system PATH for convenience.

bash
echo 'export PATH="/opt/logcraft/bin:$PATH"' >> ~/.bashrc
bash
source ~/.bashrc

Install a License

Upload the license file to the target server and apply it with the following command:

bash
logcraft license set /path/to/license/file.lic

Next step

If installing on Red Hat Linux—or a derivative such as Rocky Linux—proceed to SELinux

Otherwise, congratulations, LogCraft is installed 🎉