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:
groupadd --system logcraft
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:
% 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
:
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.
/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.
chown -R logcraft:logcraft /opt/logcraft
Finally, although optional, it’s recommended to add LogCraft’s bin
directory to the system PATH for convenience.
echo 'export PATH="/opt/logcraft/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Install a License
Upload the license file to the target server and apply it with the following command:
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 🎉