How do I install DNN manually? Print

  • dnn install, dotnetnuke, dnn, dnn migration, dnn upgrade
  • 0

DNN Platform Installation Guide for Plesk Windows Hosting

Overview

This guide provides step-by-step instructions for installing DNN Platform (formerly DotNetNuke) on your Plesk Windows hosting account. DNN Platform is the leading open-source web content management platform (CMS) in the Microsoft ecosystem, perfect for building professional websites, portals, and web applications.

Professional Installation Service

Need assistance with installation? AWH offers professional DNN Platform installation services for $99. This service includes complete setup, configuration, and post-installation testing to ensure your DNN Platform is properly configured and ready to use. Contact AWH support to schedule your professional installation.

Prerequisites for Plesk Windows Hosting

Your Plesk Windows hosting account includes all necessary components:

  • Windows Server with IIS web server
  • .NET Framework 4.8.0+ support
  • Microsoft SQL Server database access
  • Plesk control panel for easy management

Supported DNN Platform Versions

  • DNN Platform 10.0.0 and later (recommended)
  • Requires .NET Framework 4.8.0+
  • Compatible with SQL Server 2017, 2019, 2022, and Azure SQL Database

Critical: Web Application Firewall (WAF) Configuration

⚠️ IMPORTANT: Before beginning the installation, you MUST disable your Web Application Firewall (WAF) in Plesk during the installation process. Once installation is complete, you can re-enable the WAF.

To disable WAF in Plesk:

  1. Log into your Plesk control panel
  2. Navigate to Websites & Domains
  3. Click on your domain name
  4. Go to Web Application Firewall (ModSecurity)
  5. Set the WAF to "Off" or "Detection Only"
  6. Click "Apply"

Installation Steps

Step 1: Download DNN Platform

  1. Visit the official DNN Platform releases page: https://github.com/dnnsoftware/Dnn.Platform/releases
  2. Download the latest DNN_Platform_x.x.x_Install.zip file
  3. Extract the zip file to your local computer

Note: If Windows blocks the download, right-click the ZIP file, select "Properties," and click "Unblock" if the option appears.

Step 2: Create Database in Plesk

  1. Log into your Plesk control panel
  2. Go to Websites & Domains
  3. Click "Databases"
  4. Click "Add Database"
  5. Complete the database creation form:
    • Database name: Choose a name (e.g., dnn_platform)
    • Database server: Select your default MS SQL server
    • Related site: Select your domain
  6. Create a database user:
    • Check "Create a database user"
    • Database user name: Enter a username
    • New password: Create a strong password
    • Confirm password: Re-enter the password
    • Check "User has access to all databases within the selected subscription"
  7. Click "OK"
  8. Record your database details (you'll need these during installation):
    • Database server name
    • Database name
    • Username
    • Password

Step 3: Upload DNN Platform Files

  1. In Plesk, go to Websites & Domains
  2. Click "File Manager"
  3. Navigate to your domain's document root (usually httpdocs folder)
  4. If installing in a subdirectory, create and navigate to that folder
  5. Click "Upload Files"
  6. Upload the DNN_Platform_x.x.x_Install.zip file
  7. After upload, click on the zip file and select "Extract Files"
  8. Confirm extraction to extract all files to the current directory

Step 4: Set File Permissions

  1. In the Plesk File Manager, select your domain's root directory (or DNN installation directory)
  2. Click the "Change Permissions" button (folder icon with gear)
  3. Ensure the following permissions are set:
    • Owner: Read, Write, Execute
    • Group: Read, Execute
    • Others: Read, Execute
  4. Check "Apply to subdirectories and files"
  5. Click "OK"

Step 5: Start DNN Platform Installation

  1. Open your web browser
  2. Navigate to your domain (e.g., https://yourdomain.com)
    • If installing in a subdirectory: https://yourdomain.com/subdirectory
  3. The DNN Platform installation wizard should automatically launch

Step 6: Complete Installation Wizard

Administrative Information

  1. Username: Enter your SuperUser account name (default: "host")
  2. Password: Create a strong password (minimum 7 characters with letters, numbers, symbols)
  3. Confirm Password: Re-enter your password
  4. Email: Enter your email address for notifications

Website Information

  1. Website Title: Enter your website's title
  2. Template: Choose your preferred option:
    • Blank Template: Start with empty site
    • Default Template: Include sample content and help resources
  3. Language: Select your preferred language

Database Connection

  1. Database Setup: Select "Custom"
  2. Enter your database information from Step 2:
    • Database Type: SQL Server/SQL Server Express Database
    • Server Name: Your database server name (from Plesk)
    • Database Name: Your database name
    • Database Username: Your database username
    • Database Password: Your database password
    • Object Qualifier: Leave blank (unless you need to share the database)
  3. Click "Test Connection" to verify
  4. When connection test succeeds, click "Next"

Installation Summary

  1. Review all your settings
  2. Click "Install" to begin installation
  3. Wait for the installation process to complete (may take 5-10 minutes)
  4. Click "Finish" when installation is complete

Step 7: Post-Installation Security & Configuration

Remove Installation Files

  1. Return to Plesk File Manager
  2. Navigate to your DNN installation directory
  3. Delete the "Install" folder - this is critical for security
  4. Delete the installation zip file if still present

Re-enable Web Application Firewall

  1. Go back to Websites & Domains in Plesk
  2. Click your domain name
  3. Go to Web Application Firewall (ModSecurity)
  4. Set the WAF back to "On"
  5. Click "Apply"

Access Your New DNN Platform Site

  1. Visit your website URL
  2. To access admin features, add /login to your URL (e.g., https://yourdomain.com/login)
  3. Login with the SuperUser credentials you created during installation

Troubleshooting Common Plesk Issues

Installation Wizard Won't Load

  • Ensure WAF is disabled in Plesk
  • Check that all files were properly extracted
  • Verify file permissions are set correctly

Database Connection Fails

  • Double-check database credentials in Plesk under Databases
  • Ensure database user has proper permissions
  • Verify the database server name is correct

404 Errors After Installation

  • Check that files are in the correct directory (usually httpdocs)
  • Ensure the application pool is set to the correct .NET Framework version
  • Contact AWH support if issues persist

Permission Errors

  • Use Plesk File Manager to reset permissions on the installation directory
  • Ensure "Apply to subdirectories and files" was checked

Managing Your DNN Platform Site in Plesk

Regular Maintenance

  • Backups: Use Plesk's backup feature to regularly backup your site and database
  • Updates: Monitor DNN Platform releases for security updates
  • Database: Monitor database size and performance through Plesk

Performance Optimization

  • Enable compression in Plesk hosting settings
  • Consider enabling Plesk caching features
  • Monitor resource usage through Plesk statistics

Support Resources

AWH Support

  • For hosting-related issues: Contact AWH support
  • For professional installation service ($99): Contact AWH support

DNN Platform Community

  • Official Documentation: https://docs.dnncommunity.org/
  • Community Forums: https://dnncommunity.org/forums
  • GitHub Repository: https://github.com/dnnsoftware/Dnn.Platform

Security Best Practices for Plesk Hosting

  1. Keep WAF enabled when not installing/upgrading
  2. Regular backups using Plesk backup tools
  3. Monitor login attempts through DNN admin panel
  4. Update DNN Platform when new versions are released
  5. Use strong passwords for all accounts
  6. Limit SuperUser accounts to necessary personnel only

Last Updated: September 2025
Applies To: DNN Platform 10.0.0+ on Plesk Windows Hosting
Service: Professional Installation Available for $99


Was this answer helpful?

« Back