Cómo instalar el software de gestión de proyectos Kanboard en Debian 10
Kanboard es un software de gestión de proyectos gratuito, de código abierto y autoalojado que puede utilizarse para gestionar proyectos utilizando la metodología Kanban. Puedes visualizar el flujo de trabajo, limitar el trabajo en curso y trabajar eficazmente desde la interfaz web de Kanboard. Kanban te permite personalizar tus tableros según tus necesidades. Puedes ampliar la funcionalidad de Kanbord con plugins y servicios de terceros.
En este tutorial, te guiaremos paso a paso sobre cómo instalar y configurar Kanboard en Debian 10.
Requisitos
- Un servidor que ejecute Debian 10.
- Una contraseña de root configurada en tu servidor.
Cómo empezar
Se recomienda actualizar tu sistema con la última versión. Puedes actualizar todos los paquetes con el siguiente comando:
apt-get update -y apt-get upgrade -y
Una vez actualizados todos los paquetes, reinicia tu sistema para aplicar los cambios de configuración.
Instalar el servidor LEMP
Kanboard se ejecuta en el servidor web, escrito en PHP y utiliza MariaDB para el backend de la base de datos. Por lo tanto, necesitarás instalar Nginx, MariaDB, PHP y otros módulos PHP en tu sistema.
apt-get install nginx mariadb-server php7.3 php7.3-common php7.3-cli php7.3-fpm php7.3-mbstring php7.3-json php7.3-opcache php7.3-zip php7.3-xml php7.3-gd php7.3-ldap php7.3-mysql php7.3-json php7.3-sqlite3
Una vez completada la instalación, inicia el servicio Nginx y MariaDB, y habilítalos para que se inicien tras reiniciar el sistema con el siguiente comando:
systemctl start nginx systemctl start mariadb systemctl enable nginx systemctl enable mariadb
Configurar MariaDB para Kanboard
Por defecto, MariaDB no está protegida, por lo que se recomienda protegerla. Puedes asegurarlo ejecutando el siguiente script.
mysql_secure_installation
Responde a todas las preguntas como se muestra a continuación:
Enter current password for root (enter for none):
Set root password? [Y/n]: N
Remove anonymous users? [Y/n]: Y
Disallow root login remotely? [Y/n]: Y
Remove test database and access to it? [Y/n]: Y
Reload privilege tables now? [Y/n]: Y
Una vez que MariaDB esté protegida, accede al shell de MariaDB:
mysql -u root -p
Introduce tu contraseña de root cuando se te pida, y luego crea una base de datos y un usuario para Kanboard:
MariaDB [(none)]>CREATE DATABASE kanboard CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
A continuación, concede todos los privilegios a la base de datos Kanboard con el siguiente comando:
MariaDB [(none)]>GRANT ALL PRIVILEGES ON kanboard.* TO 'kanboard'@'localhost' IDENTIFIED BY 'mypassword';
Sustituye la palabra ‘micontraseña‘ por una contraseña segura de tu elección en el comando SQL anterior. A continuación, elimina los privilegios con el siguiente comando:
MariaDB [(none)]>FLUSH PRIVILEGES;
Por último, sal del intérprete de comandos MariaDB con el siguiente comando:
MariaDB [(none)]>\q
Instalar Kanboard
En primer lugar, descarga la última versión de Kanboard desde el repositorio Git con el siguiente comando:
wget https://github.com/kanboard/kanboard/archive/v1.2.10.tar.gz
Una vez finalizada la descarga, extrae el archivo descargado con el siguiente comando:
tar -xvf v1.2.10.tar.gz
A continuación, copia el directorio extraído al directorio raíz web de Apache con el siguiente comando:
cp -r kanboard-1.2.10 /var/www/html/kanboard
A continuación, copia el archivo de configuración de ejemplo de Kanboard con el siguiente comando:
cd /var/www/html/kanboard cp config.default.php config.php
A continuación, abre el archivo config.php con tu editor preferido:
nano config.php
Define la configuración de tu base de datos como se muestra a continuación:
// Database driver: sqlite, mysql or postgres (sqlite by default)
define('DB_DRIVER', 'mysql');
// Mysql/Postgres username
define('DB_USERNAME', 'kanboard');
// Mysql/Postgres password
define('DB_PASSWORD', 'password');
// Mysql/Postgres hostname
define('DB_HOSTNAME', 'localhost');
// Mysql/Postgres database name
define('DB_NAME', 'kanboard');
Guarda y cierra el archivo cuando hayas terminado. A continuación, establece los permisos adecuados con el siguiente comando:
chown -R www-data:www-data /var/www/html/kanboard
Cuando hayas terminado, puedes pasar al siguiente paso.
Configurar Nginx para Kanboard
A continuación, tendrás que crear un archivo de host virtual Nginx para Kanboard. Puedes crearlo con el siguiente comando:
nano /etc/nginx/conf.d/kanboard.conf
Añade las siguientes líneas:
server {
listen 80;
server_name example.com;
index index.php;
root /var/www/html/kanboard;
client_max_body_size 32M;
location / {
try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_index index.php;
include fastcgi_params;
}
location ~* ^.+\.(log|sqlite)$ {
return 404;
}
location ~ /\.ht {
return 404;
}
location ~* ^.+\.(ico|jpg|gif|png|css|js|svg|eot|ttf|woff|woff2|otf)$ {
log_not_found off;
expires 7d;
etag on;
}
gzip on;
gzip_comp_level 3;
gzip_disable "msie6";
gzip_vary on;
gzip_types
text/javascript
application/javascript
application/json
text/xml
application/xml
application/rss+xml
text/css
text/plain;
}
Guarda y cierra el archivo cuando hayas terminado. A continuación, comprueba si Nginx tiene algún error de sintaxis con el siguiente comando:
nginx -t
Deberías ver la siguiente salida:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful
Por último, reinicia Nginx y el servicio php-fpm con el siguiente comando:
systemctl restart nginx systemctl restart php7.3-fpm
Puedes comprobar el estado del servicio Nginx con el siguiente comando:
systemctl status nginx
Deberías ver la siguiente salida:
? nginx.service - A high performance web server and a reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: active (running) since Sat 2019-07-13 06:05:09 EDT; 26s ago
Docs: man:nginx(8)
Process: 13412 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
Process: 13413 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
Main PID: 13414 (nginx)
Tasks: 2 (limit: 1138)
Memory: 2.9M
CGroup: /system.slice/nginx.service
??13414 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
??13415 nginx: worker process
Jul 13 06:05:09 debian systemd[1]: Starting A high performance web server and a reverse proxy server...
Jul 13 06:05:09 debian systemd[1]: nginx.service: Failed to parse PID from file /run/nginx.pid: Invalid argument
Jul 13 06:05:09 debian systemd[1]: Started A high performance web server and a reverse proxy server.
Accede a la interfaz web de Kanboard
Kanboard ya está instalado y configurado, es hora de acceder a la interfaz web de Kanboard.
Abre tu navegador web y escribe la URL http://example.com. Se te redirigirá a la siguiente página:
Introduce el nombre de usuario y la contraseña de administrador por defecto como admin / admin y haz clic en el botón Iniciar sesión. Deberías ver el panel de control por defecto de Kanboard en la siguiente página:
Se recomienda cambiar la contraseña de administrador por defecto. Para ello, ve a Admin > Gestión de Usuarios > admin. Deberías ver la siguiente página:
Ahora, haz clic en el botón Cambiar contraseña. Deberías ver la siguiente página:
proporciona tu nueva contraseña y haz clic en el botón Guardar.
Enhorabuena! has instalado y configurado correctamente Kanboard en Debian 10. Ahora puedes gestionar tus tareas fácilmente desde la interfaz web de Kanboard. No dudes en preguntarme si tienes alguna duda.