Run OCC Maintenance Commands in Nextcloud AIO

🎯 Purpose

To perform maintenance, repairs, and database optimizations on your Nextcloud AIO instance using the built-in occ command-line interface.

📍 Requirements

• Access to the server where Nextcloud AIO is deployed
• Docker installed and running
• Container name (usually nextcloud-aio-nextcloud)

🛠 Step-by-Step Instructions

1. SSH Into Your Server

ssh mslsadmin@cloud

2. Enter the Nextcloud Container

docker exec -it nextcloud-aio-nextcloud bash

Note: You'll now be inside the container as root. All occ commands must run as the www-data user.

3. Run Standard Repair

sudo -u www-data php occ maintenance:repair

This command performs:

• Missing index creation
• Mimetype corrections
• Database constraints
• App cleanup routines

4. Run Full Repairs with Expensive Operations (Optional)

sudo -u www-data php occ maintenance:repair --include-expensive

This version also:

• Migrates mimetypes for large datasets
• May take several minutes to complete

🔁 Other Common OCC Maintenance Tasks

Disable Maintenance Mode

sudo -u www-data php occ maintenance:mode --off

Enable Maintenance Mode

sudo -u www-data php occ maintenance:mode --on

Clear File Cache (Use with caution)

sudo -u www-data php occ files:cleanup

✅ After Running

• Exit the container:

  exit

• Refresh Settings > Overview in your Nextcloud web UI
• Warnings should disappear and system health will improve

Maintained by MSLS Partners LLC — Internal Nextcloud Guide