How to install Umbraco manually
I've installed Umbraco a million times, so I know how it works. But sometimes people get frustrated when they're starting with Umbraco for the first time.
Sorry XP users, this is written for Windows 7 (you really need to update your 11 year old OS, really). Also, please remember that there's a thousand different computer configurations out there, so this might not be entirely accurate for your specific computer.
So here's a step-by-step guide. This is most certainly not the easiest way of installing Umbraco, but it gives you and overview of how you can do it completely manually, without tools like the Web Platform Installer or Webmatrix.
Let's get started:
- Download the latest Umbraco release (choose the umbraco binaries, please don't try to install from the source, if you're a new user you really don't need to touch the source for months at least)
- Unzip the files into the directory in which you want to install Umbraco. In this example I will do it in: D:\Dev\MyNewUmbracoSite
Note: Before you unzip the umbraco binaries, right-click the zip file and choose "Properties", then hit the "Unblock" button to make sure none of the dll's will be blocked. I use 7zip in which you don't have to do this.
- Here we're going to do ourselves a huge favor by not installing Umbraco in a virtual directory.
In my hosts file, I now add a new domain name, that I want to use for my site, in my case: mynewumbracosite.local
The hosts file can be found in: C:\Windows\System32\drivers\etc
Make sure that the current windows user has permissions to the hosts file, as of Windows 7 this file is not writable by default.
Add the entry:
When that is done, the site can be created in IIS.
- Start your IIS Manager and right click on "Sites" and choose "Add web site".
- The site name will be MyNewUmbracoSite, the Physical path will be D:\Dev\MyNewUmbracoSite and the Host name is: mynewumbracosite.local
The application pool should be changed to use the ASP.NET v4.0 app pool.
Note: the application pool should be configured to use integrated pipeline mode (this is the default for the ASP.NET v.4.0 app pool).
- Next, you should set some permissions so that IIS is able to execute the pages in your site, right-click on the MyNewUmbracoSite folder in D:\Dev, choose Properties and go to Security. Then click the Edit button and the Add button. Find the IIS_IUSRS account and give is Full Control permissions.
Make sure to read more information about setting permissions as just giving full control everywhere is not best practice.
- Alright, almost ready to start the install process, go into your SQL Server management studio and create a new database (for example: mynewumbracosite).
- In the Security\Logins section of Management Studio, create a new user (SQL Server authentication, remember to uncheck "Enforce password policy").
Remember the credentials, mine will be umbraco / password
- Go back into your database and go to Security\Users.
Enter the username umbraco in both user name and login name fields. Enter dbo in the default schema field and make the user db_owner for schemas and roles.
- Now you can go to http://mynewumbracosite.local/ and you should be presented with the setup screen.
- Go through the wizard and when asked for a database, choose "I already have a blank SQL Server or MySQL database" and then "Microsoft SQL Server".
- Enter the server name, database name and credential that you just made and click "Install".
- As prompted by the installer, create a new user for your umbraco login.
- For the next step in the install wizard, if you want install a starter kit do so, if not choose not to.
- When you hit next, you're done.
Please leave a comment when there's something unclear. If you follow along and do things exactly like in this guide, you should be good to go.