Cómo instalar la aplicación de seguimiento de tiempo basada en web Kimai en Linux

Gracias a este post, aprenderás a instalar Kimai en Linux.

Introducción

Kimai es una aplicación gratuita de seguimiento del tiempo (código abierto), Con Kimai, el aburrido proceso de alimentar hojas de cálculo de Excel con sus horas de trabajo no solo se simplifica, sino que también ofrece docenas de otras características interesantes que ni siquiera conoce. te estás perdiendo hasta ahora!

Kimai no tiene que ejecutarse durante la grabación, incluso puede salir de su navegador. Tu tiempo sigue grabándose hasta que lo detengas desde cualquier navegador web que tenga acceso a tu instalación. Está diseñado para albergar a muchos usuarios, pero también puede usarlo para un solo usuario si lo desea.

Lista de funciones

La siguiente lista es sobre las características que ofrece Kimai.

Entonces, en este artículo, ilustraremos cómo instalar y usar kimai en Ubuntu 20.04

instalar Kimai en Linux

Simplemente siga los pasos a continuación para comenzar con kimai.

• Actualice, prepare su servidor e instale utilidades importantes.

sudo apt update && sudo apt upgrade 
sudo apt install git curl vim

• Instale y configure la base de datos, instalaremos el servidor mariadb, así que simplemente ejecute el siguiente comando.

apt install mariadb-server

• Iniciar y habilitar el servicio mariadb.

systemctl start mariadb
systemctl enable mariadb

• Active y asegure la instalación de mariadb con el siguiente comando:

mysql_secure_installation

• El siguiente paso es crear una base de datos y un usuario para Kimai .

mysql -u root -p

• Crear base de datos y usuario para Kimai

CREATE DATABASE kimai_db;
CREATE USER 'kimai_usr'@'localhost' IDENTIFIED BY 'unixcopPassword';
GRANT ALL PRIVILEGES ON kimai_db . * TO 'kimai_usr'@'localhost';
FLUSH PRIVILEGES;
\q

• Instalar y configurar un servidor web para kimai.

apt install nginx php-fpm

• Inicie y habilite el servidor web ngin.

systemctl start nginx
systemctl enable nginx

• Agregue la configuración de PHP recomendada

vim /etc/php/7.4/fpm/php.ini

• Luego edite los siguientes valores

memory_limit = 512M 
date.timezone = Africa/Cairo

• Instale todas las extensiones php requeridas

sudo apt install -y php-intl php-gd php-bcmath php-fpm php-json php-curl php-cli php-curl php-xml php-pear php-common php-mysql php-zip php-gd php-mbstring 

• Instale Composer, que instala las dependencias de PHP que requiere un proyecto.

curl -sS https://getcomposer.org/installer -o composer-setup.php
sudo php composer-setup.php --version=1.10.17 --install-dir=/usr/local/bin --filename=composer

• Instalar Kiami desde Git

cd /var/www/html/
sudo git clone -b 1.11.1 --depth 1 https://github.com/kevinpapst/kimai2.git
cd kimai2/
sudo composer install --no-dev --optimize-autoloader

• Configure la conexión de la base de datos en .env archivo configurando el nombre de usuario, la contraseña y la base de datos que configuramos antes

sudo vim /var/www/html/kimai2/.env

• Luego, edite la URL de la base de datos y haga un hash de la línea sqlite de la siguiente manera:

DATABASE_URL=mysql://kimai_usr:[email protected]:3306/kimai_db
#DATABASE_URL=sqlite:///%kernel.project_dir%/var/data/kimai.sqlite

• Ejecute el instalador de Kimai

cd /var/www/html/kimai2
bin/console kimai:install -n

• Cree su primer usuario. y asegúrese de que su contraseña tenga más de 8 caracteres.

sudo bin/console kimai:create-user username admin@unixcop ROLE_SUPER_ADMIN

• El siguiente paso es generar certificados SSL/TLS autofirmados

Una vez que finalice el instalador de Kimai, generaremos certificados SSL/TLS para la conexión SSL de Nginx y crearemos un archivo de configuración de Nginx para definir la configuración de Kimai. Esto es solo para hacer las cosas un poco seguras.

sudo mkdir /etc/ssl/private
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/ssl/private/kimai-selfsigned.key -out /etc/ssl/certs/kimai-selfsigned.crt

Una vez hecho esto, generaremos el grupo Deffie-Hellman de la siguiente manera. Tardará algún tiempo en completarse.

sudo openssl dhparam -out /etc/ssl/certs/dhparam.pem 2048

Luego establezca el valor de types_hash_max_size en 4096 en el archivo de configuración de Nginx.

sudo sed -i 's/types_hash_max_size 2048/types_hash_max_size 4096/' /etc/nginx/nginx.conf

• Ahora configuraremos el archivo nginx para kimai.

cd /etc/nginx/sites-enabled/ 
sudo mv default /tmp

• Cree un nuevo archivo y agregue los detalles que se muestran a continuación. Si tiene un FQDN, reemplace unixcop.com con eso.

sudo vim kimai.conf

• Luego agregue lo siguiente:

server {
    listen 80;
    server_name kimai.unixcop.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    server_name kimai.unixcop.com;

    root /var/www/html/kimai2/public/;
    index index.php index.htm index.nginx-debian.html;

        ssl_certificate /etc/ssl/certs/kimai-selfsigned.crt;
    ssl_certificate_key /etc/ssl/private/kimai-selfsigned.key;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on; 
    ssl_dhparam /etc/ssl/certs/dhparam.pem;
    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384;
    ssl_ecdh_curve secp384r1;
    ssl_session_timeout  10m;
    ssl_session_cache shared:SSL:10m;
    resolver 8.8.8.8 valid=300s;
    resolver_timeout 5s; 
    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload";
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";

    location ~ /\.ht {
        deny all;
    }
    location / {
                try_files $uri /index.php$is_args$args;
    }

        location ~ ^/index\.php(/|$) {
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
        fastcgi_index index.php;
        fastcgi_read_timeout 240;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_split_path_info ^(.+.php)(/.+)$;
        }
    location ~ \.php$ {
        return 404;
    }
 }

• Cambiar los permisos de archivos de Kimai

sudo chown -R www-data:www-data /var/www/html/kimai2/public/
sudo chmod -R g+rw /var/www/html/kimai2/var/
sudo chmod -R 755 /var/www/html/kimai2/public/
sudo chmod -R g+rw /var/www/html/kimai2/public/avatars/
sudo systemctl restart nginx php7.4-fpm

• Permitir los puertos 80 y 443 en el cortafuegos

sudo ufw allow 80,443/tcp

Acceder a la interfaz web de Kimai

• Abra su navegador en la IP o el nombre de dominio del servidor web que sirve los archivos. https://[ip-or-domain-name] .
• Luego inicie sesión con el usuario que creamos.

• Acceda al panel de control.

• Para crear un usuario , navegue hasta la sección "Usuarios Pestaña en el tablero de Kimai y haz clic en él. Después de eso, haga clic en + para crear un nuevo usuario.

• Ingrese los detalles como se muestra a continuación y luego haga clic en "Guardar ” como se muestra arriba
• Después de guardarlo, aparecerá una nueva página donde podrá agregar "Roles " y el resto. Ingrese los roles correctos para el usuario. Haga esto para tantos usuarios como tenga.

• Haga clic en los usuarios nuevamente para verificar que creó un usuario como se muestra a continuación.

• Para crear un Equipo , La creación de equipos está limitada a los roles de usuario Administrador del sistema y Administrador. Vaya a "Equipos Pestaña en el tablero de Kimai y haz clic en él. Haga clic en + ubicado en la parte superior derecha para crear un nuevo equipo.

• Ingrese los detalles del equipo que está creando.

• También puede agregar Proyectos, Actividades y complementos.

• Compruebe que el equipo se haya creado navegando a Equipos

Conclusión

Eso es todo,

En esta guía, le mostramos cómo instalar y usar kimai en Ubuntu 20.04

Gracias