Activity

1. XenGi

   added

   triage needed

   on Jan 31, 2026
2. XenGi

   added the

   Bug

   issue type on Jan 31, 2026
3. fguillot commented on Jan 31, 2026

   

   fguillot

   on Jan 31, 2026

   Member

   More actions

   As per the documentation, there are 3 requirements to enable the plugin installer in the web ui:

   • The plugin directory must be writable by the web server user.
   • The PHP Zip extension must be available on your server.
   • The config parameter PLUGIN_INSTALLER must be set to true.

   Source: https://docs.kanboard.org/v1/admin/plugins/

   Does your server is configured to meet these 3 requirements?

   You can also compare your local PHP-FPM configuration with the official Docker image to see if something is missing on your side: https://github.com/kanboard/kanboard/tree/main/docker/etc/php84
4. fguillot

   removed

   triage needed

   on Jan 31, 2026
5. fguillot

   changed the issue type from

   Bug

   to

   Configuration

   on Jan 31, 2026
6. fguillot

   changed the title [-][Bug]: Config values via ENV are not applied[/-] [+][Configuration]: Config values via ENV are not applied[/+] on Jan 31, 2026
7. XenGi commented on Jan 31, 2026

   

   XenGi

   on Jan 31, 2026

   Author

   More actions

   I'll have a closer look what the nix module does and report back. Still not sure if the problem is within nix, kanboard itself or me.
8. XenGi commented on Feb 1, 2026

   

   XenGi

   on Feb 1, 2026

   Last edited by XenGi

   Author

   More actions

   The plugin directory must be writable by the web server user

   I'm not sure about that first requirement. The Nginx only talks to php-fpm. So I guess the plugin dir needs to be writable by the user who runs php-fpm which in my case is kanboard? I tried both kanboard and nginx. Still no success.

   $ ls -la /var/lib/kanboard/plugins
   total 8
   drwxrwxr-x 2 kanboard kanboard 4096 Feb  1 15:48 .
   drwx------ 4 kanboard kanboard 4096 Feb  4 13:11 ..
   

   The PHP Zip extension must be available on your server

   Zip is enabled.

   $ php -i
   zip
   
   Zip => enabled
   Zip version => 1.22.7
   Libzip version => 1.11.4
   BZIP2 compression => No
   XZ compression => No
   ZSTD compression => No
   AES-128 encryption => No
   AES-192 encryption => No
   AES-256 encryption => No
   

   The config parameter PLUGIN_INSTALLER must be set to true.

   It is enabled via Environment variable.

   $ cat phpfpm-kanboard.conf
   [kanboard]
   env[PLUGINS_DIR] = /var/lib/kanboard/plugins
   env[PLUGIN_INSTALLER] = true
   

   kanboard is started via systemd like this (shortened paths):

   ExecStart=php-fpm -y phpfpm-kanboard.conf -c php.ini
   
9. XenGi commented on Feb 4, 2026

   

   XenGi

   on Feb 4, 2026

   Author

   More actions

   I had a look at the code again.

   This part defines the constants from the environment variables.

   // https://github.com/kanboard/kanboard/blob/main/app/constants.php#L19
   defined('PLUGINS_DIR') or define('PLUGINS_DIR', getenv('PLUGINS_DIR') ?: ROOT_DIR.DIRECTORY_SEPARATOR.'plugins');
   defined('PLUGIN_INSTALLER') or define('PLUGIN_INSTALLER', strtolower(getenv('PLUGIN_INSTALLER')) === 'true');

   This part is the check if all 3 reuirements are true.

   // https://github.com/kanboard/kanboard/blob/main/app/Core/Plugin/Installer.php#L23
   public static function isConfigured() {
     return PLUGIN_INSTALLER && is_writable(PLUGINS_DIR) && extension_loaded('zip');
   }

   I'm still investigating but can't find why it doesn't work so far.