Tutorial: Installing ViMbAdmin on Windows 10

  1. Install XAMPP software from https://www.apachefriends.org/download.html, according to your Windows version. XAMPP is the software package used to run ViMbAdmin on Windows 10.
  2. After installing XAMPP, open it and start Apache and MySQL services.
  3. Download ViMbAdmin from https://github.com/opensolutions/ViMbAdmin/releases, selecting the latest version.
  4. Unzip the downloaded file to a folder in your preferred location on your computer.
  5. In the folder where you unzipped ViMbAdmin, navigate to the inc folder and locate the config.inc.php.dist file.
  6. Rename the file from config.inc.php.dist to config.inc.php.
  7. Open the renamed config.inc.php file using a text editor such as Notepad.
  8. Locate the encryption_key setting in the file and add a random string of characters for the value.
  9. Save and close the config.inc.php file.
  10. Launch a web browser and enter localhost into the address bar.
  11. Click on phpMyAdmin in the XAMPP control panel to launch it on your browser.
  12. Create a new database for ViMbAdmin to use by clicking on the New button on the left sidebar and giving the database a name.
  13. Click on the created database to open it.
  14. Click on the Import tab and browse to the unzipped ViMbAdmin folder.
  15. Select the sql/vimbadmin.sql file and click on the Go button to import it.
  16. Return to ViMbAdmin folder and navigate to the inc folder.
  17. Locate the password_api.dist.php file and rename it to password_api.php.
  18. Open the password_api.php file in a text editor.
  19. Change the line $CONF['passwordpolicy'] = 'p4ssw0rd'; to your desired password policy.
  20. Save and close the password_api.php file.
  21. Open a web browser and enter localhost/ViMbAdmin-<version> into the address bar, replacing with the version of ViMbAdmin you downloaded.
  22. ViMbAdmin installation page will be displayed. Follow the instructions and enter the necessary details, including the server name, the database name, username, and password, as well as the LDAP settings.
  23. After completing the form, click on the Install button.
  24. A confirmation message "Installation completed successfully" will be displayed. Click on the ViMbAdmin link to access your new installation.

Congratulations! You have successfully installed ViMbAdmin on your Windows 10 computer.