Knowledge Base

How to install Umbraco CMS manually

This article describes how to manually install the Umbraco Content Management System.

Installing Umbraco CMS

Umbraco CMS is compatible with all Windows hosting accounts.

Step 1: Set up the database

Umbraco CMS works with SQL Compact Edition, SQL Server 2008 (Express and higher), or MySQL 5 (or higher). The MySQL option requires custom configuration and only works with Windows hosting accounts that include full administrative access.

SQL Compact Edition is used by default during installation of the software. No prior setup is required for SQL Compact edition.

To use SQL Server or MySQL, you must first create a new database. To do this, follow these steps:

  1. Log in to Plesk.
    If you do not know how to log in to your Plesk account, please see this article.
  2. In the left sidebar, click Databases:

    Databases option in Plesk sidebar.

  3. On the following page, click Add Database:

    Add database button from toolbar
  4. In the Database name text box, type a descriptive name for the database
  5. In the Database server list box, select the database type.
  6. Select the Create a database user check box if it is not already selected.
  7. In the Database user name text box, type a unique user name.
  8. In the New password text box, type a password.
  9. In the Confirm password text box, type the password again.
  10. Make a note of the database name, database server address, database user name, and password for use during software installation.
  11. Click OK to finish creating the database.

Step 2: Upload the Umbraco CMS files

After you set up the database, you are ready to upload the Umbraco CMS files. To do this, follow these steps:

  1. Use your web browser to go to https://our.umbraco.com/download and then download the Umbraco CMS installation file to your local computer.
  2. In Plesk, in the left sidebar, click Files to open the File Manager.
  3. Use the File Manager to select the installation directory for Umbraco. To have the Umbraco installation appear at the root of your domain, select the httpdocs directory:
  4. In the toolbar at the top of the File Manager, click Upload:
  5. In the pop-up dialog box, select the Umbraco CMS file you downloaded in step 1.
  6. After the file is uploaded, select the check box to the left of the filename:
  7. In the toolbar at the top of the File Manager, click Extract Files:
  8. In the pop-up dialog box, click OK to confirm the file extraction.

Step 3: Run the install

To run the installation process, follow these steps:

  1. In a new browser tab, navigate to the domain where Umbraco will be installed. The Umbraco installation should start automatically.
  2. Type your full name, e-mail address, and a password as indicated on the page.
  3. Select a database to use:
    • To use the default SQL Compact Edition database, click Install.
    • Alternatively, to use SQL Server or MySQL, follow these steps:
      1. Click Customize.
      2. On the following page, in the Database type list box, select the preferred database.
      3. Type the database name, database server address, database user name, and password that you used during database setup.
      4. Click Continue.
  4. The installation completes and opens Umbraco CMS at the Get Started page.

Step 4: Post-install tasks

To complete the installation process, follow these steps:

  1. In Plesk, return to the File Manager and select the installation directory for Umbraco.
  2. Locate the Umbraco installation file, and then select the check box to the left of the filename:
  3. In the toolbar at the top of the File Manager, click Remove:
  4. Click the Umbraco folder to open it.
  5. Insde the Umbraco folder, locate the Install folder, and then select the check box to the left of the folder:
  6. In the toolbar at the top of the File Manager, click Remove.

Step 5: Set up e-mail (optional)

If you need to send e-mail with the Umbraco site, some additional configuration steps are required:

  1. In Plesk, create an e-mail account for the Umbraco installation to use. For information about how to do this, please see this article.
  2. In the left sidebar, click Files to open the File Manager:
  3. Use the File Manager to select the installation directory for Umbraco:
  4. Locate the web.config file, and then click the filename to open it in the code editor:
  5. In the code editor, scroll down until you locate the <mailSettings> tag.
  6. In the <mailSettings> section, type the information for the email account that you created in step 1 as shown below. Replace [email protected] and password with the values from the account you created in step 1:
    <smtp from="[email protected]">
        <network host="127.0.0.1" userName="[email protected]" password="password" />
  7. Click OK to save and close the file.