Skip to content

Post Deployment Verification

Cotechnoe edited this page May 26, 2026 · 3 revisions

Post-Deployment Verification

🇫🇷 Cette page est également disponible en français : fr-Post-Deployment-Verification

After deploying and connecting via SSH, verify that all four core services are running correctly before configuring Nextcloud.


Prerequisites


Step 1 — Verify Nginx

Nginx serves as the web server and reverse proxy.

sudo systemctl status nginx

Expected output includes Active: active (running).

If Nginx is not running, start it:

sudo systemctl start nginx
sudo systemctl enable nginx

Test HTTP response:

curl -I http://localhost

Expected: HTTP/1.1 200 OK or a redirect to HTTPS.


Step 2 — Verify PHP-FPM

PHP-FPM processes PHP requests for Nextcloud.

sudo systemctl status php8.3-fpm

Expected output includes Active: active (running).

If PHP-FPM is not running, start it:

sudo systemctl start php8.3-fpm
sudo systemctl enable php8.3-fpm

Verify PHP version:

php --version

Expected: PHP 8.3.


Step 3 — Verify PostgreSQL

PostgreSQL stores the Nextcloud database.

sudo systemctl status postgresql

Expected output includes Active: active (running).

If PostgreSQL is not running, start it:

sudo systemctl start postgresql
sudo systemctl enable postgresql

Test database connectivity:

sudo -u postgres psql -c "\\l"

Expected: A table listing databases including nextcloud (if already configured).


Step 4 — Verify Redis

Redis provides session caching and file locking for Nextcloud.

sudo systemctl status redis-server

Expected output includes Active: active (running).

If Redis is not running, start it:

sudo systemctl start redis-server
sudo systemctl enable redis-server

Test Redis connectivity:

redis-cli ping

Expected: PONG


Summary Check

Run all checks in one command:

for svc in nginx php8.3-fpm postgresql redis-server; do
  echo "=== $svc ===" && sudo systemctl is-active "$svc"
done

All four services should report active.


Verify

Service Check command Expected
Nginx sudo systemctl is-active nginx active
PHP-FPM sudo systemctl is-active php8.3-fpm active
PostgreSQL sudo systemctl is-active postgresql active
Redis sudo systemctl is-active redis-server active

Troubleshooting

Nginx fails to start: "Address already in use"
Another process is using port 80 or 443. Find it with sudo ss -tlnp | grep ':80\|:443' and stop it.

PHP-FPM fails to start: "No such file or directory"
The socket path configured in Nginx may not match what PHP-FPM creates. Check /etc/nginx/sites-available/ and /etc/php/8.3/fpm/pool.d/www.conf for socket path consistency.

PostgreSQL fails to start: "could not open file "pg_filenode.map""
Data directory issue. Check PostgreSQL logs: sudo journalctl -u postgresql --since "5 minutes ago".

Redis: redis-cli ping returns Connection refused
Verify that Redis is listening on 127.0.0.1:6379: sudo ss -tlnp | grep 6379


Next Steps

Next Page
Configure HTTPS HTTPS-TLS-Certificate
Complete Nextcloud setup Configuring-Nextcloud

Clone this wiki locally