For advanced configuration (multi-server setup, custom plugins, or high-traffic tuning), refer to the official Piwis documentation at docs.piwis.org . Last tested with Piwis 3.0.0 on Ubuntu 24.04 LTS – April 2026
cd /var/www sudo wget https://github.com/piwis/piwis/releases/download/3.0.0/piwis-3.0.0.zip sudo unzip piwis-3.0.0.zip -d piwis sudo chown -R www-data:www-data /var/www/piwis sudo chmod -R 755 /var/www/piwis/tmp Replace 3.0.0 with the actual latest version from the official releases page . Log into MySQL and create a database and user for Piwis. piwis 3 install
location ~ \.php$ include snippets/fastcgi-php.conf; fastcgi_pass unix:/var/run/php/php8.2-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; location ~ \
Enable the site and reload Nginx:
server listen 80; server_name stats.yourdomain.com; root /var/www/piwis; index index.php; location / try_files $uri $uri/ =404; location ~ \.php$ include snippets/fastcgi-php.conf
location ~ ^/(config|tmp|core|lang|plugins|vendor) deny all; return 403;
CREATE DATABASE piwis_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'piwis_user'@'localhost' IDENTIFIED BY 'strong_password_here'; GRANT ALL PRIVILEGES ON piwis_db.* TO 'piwis_user'@'localhost'; FLUSH PRIVILEGES; EXIT; Create an Nginx config file for your Piwis domain.