Skip to content

Installation Guide

This guide covers installing and updating FormVox on your Nextcloud server.

Requirements

Nextcloud Version

  • Minimum: Nextcloud 28
  • Maximum: Nextcloud 33
  • Recommended: Latest stable release

PHP Version

  • Minimum: PHP 8.2
  • Recommended: PHP 8.2 or higher

Server Requirements

  • No additional database requirements (file-based storage)
  • Standard Nextcloud server setup
  • Adequate disk space for form files

Installation Methods

  1. Log in to Nextcloud as an administrator
  2. Go to Apps (click your profile → Apps)
  3. Search for "FormVox"
  4. Click Download and enable

Manual Installation

  1. Download the latest release from GitHub

  2. Extract to your Nextcloud apps directory: 

    cd /path/to/nextcloud/apps
tar -xzf formvox-x.x.x.tar.gz

  3. Set correct permissions: 

    chown -R www-data:www-data formvox

  4. Enable the app: 

    sudo -u www-data php occ app:enable formvox

Or enable via the web interface in Apps → Disabled apps.

Post-Installation

Verify Installation

  1. Check the app is listed in Apps as enabled
  2. Look for the FormVox icon in the navigation bar
  3. Create a test form to verify functionality

MIME Type Registration

FormVox automatically registers the .fvform file type during installation. If files don't show the correct icon:

  1. Run the repair step: 

    sudo -u www-data php occ maintenance:repair

  2. Clear the file cache: 

    sudo -u www-data php occ files:scan --all

Updating FormVox

Via App Store

  1. Go to Apps
  2. Check for updates
  3. Click Update next to FormVox

Manual Update

  1. Download the new version

  2. Disable the app: 

    sudo -u www-data php occ app:disable formvox

  3. Replace the app folder: 

    rm -rf /path/to/nextcloud/apps/formvox
tar -xzf formvox-x.x.x.tar.gz -C /path/to/nextcloud/apps/

  4. Re-enable the app: 

    sudo -u www-data php occ app:enable formvox

  5. Run upgrades: 

    sudo -u www-data php occ upgrade

Uninstallation

Keep Data

To uninstall but keep form files:

  1. Disable the app: 

    sudo -u www-data php occ app:disable formvox

  2. Remove the app folder: 

    rm -rf /path/to/nextcloud/apps/formvox

Form files (.fvform) remain in users' file storage.

Complete Removal

To remove everything including form files:

  1. Delete all .fvform files from user storage
  2. Follow the steps above to uninstall the app

Troubleshooting

App Not Showing

If FormVox doesn't appear after installation:

  1. Check PHP version meets requirements: 

    php -v

  2. Check Nextcloud version: 

    sudo -u www-data php occ status

  3. Check app is enabled: 

    sudo -u www-data php occ app:list | grep formvox

  4. Check logs for errors: 

    tail -f /path/to/nextcloud/data/nextcloud.log

File Type Not Recognized

If .fvform files don't open correctly:

  1. Run maintenance repair: 

    sudo -u www-data php occ maintenance:repair

  2. Clear caches: 

    sudo -u www-data php occ maintenance:mimetype:update-db
sudo -u www-data php occ maintenance:mimetype:update-js

Permission Issues

If you see permission errors:

  1. Check app folder permissions: 

    ls -la /path/to/nextcloud/apps/formvox

  2. Fix ownership: 

    chown -R www-data:www-data /path/to/nextcloud/apps/formvox

Next Steps