Cultiv Web Solutions

How to install Umbraco manually

How to install Umbraco manually 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 ) 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.

2011-07-18_172955

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:

  1. 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)
    Umbraco -codeplex -download 
  2. 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.
    2011-07-18_182642 
  3. 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.
    2011-07-18_182807

    Add the entry:
     127.0.0.1      mynewumbracosite.local

    2011-07-18_182841
    When that is done, the site can be created in IIS.
  4. Start your IIS Manager and right click on "Sites" and choose "Add web site". 
  5. 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).
    2011-07-18_183029 
  6. 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.
    2011-07-18_183216
    Make sure to read  more information about setting permissions as just giving full control everywhere is not best practice.
  7. Alright, almost ready to start the install process, go into your SQL Server management studio and create a new database (for example: mynewumbracosite).
    2011-07-18_183332
  8. In the Security\Logins section of Management Studio, create a new user (SQL Server authentication, remember to uncheck "Enforce password policy").
    2011-07-18_183446
    2011-07-18_183510
    Remember the credentials, mine will be umbraco / password
  9. Go back into your database and go to Security\Users. 
    2011-07-18_183632
    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.
    2011-07-18_183710
  10. Now you can go to http://mynewumbracosite.local/ and you should be presented with the setup screen.
  11. 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".
  12. Enter the server name, database name and credential that you just made and click "Install".
    2011-07-18_183812
  13. As prompted by the installer, create a new user for your umbraco login.
    2011-07-18_183937
  14. For the next step in the install wizard, if you want install a starter kit do so, if not choose not to.
  15. 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.

 

13 comments on this article

Avatar for Jan Skovgaard Comment from Jan Skovgaard
Hi Seb

Just want to give you #h5yr! for taking the time to write this guide - it's added to my favourites :-)

/Jan

Avatar for Michael Comment from Michael
Ik kom niet verder bij stap 7. Zodra ik SQL Server Management Studio opstart moet ik meteen inloggen. Welke gegevens moet ik hier invoeren? Of waar kan ik buiten dit scherm een database aanmaken?

Alvast bedankt!

Avatar for Sebastiaan Janssen Comment from Sebastiaan Janssen
@Michael Daar kan ik je ook niet bij helpen, toen SQL server geïnstalleerd werd, is een wachtwoord voor het "sa" account opgegeven.

Je zou kunnen proberen in te loggen via windows authenticatie (maar dat moet tijdens de installatie van de server aan gezet zijn) of via een andere username/password die je kent voor die server.

Mocht dit allemaal geen optie zijn dan denk ik dat de enige andere oplossing is het volledig de-installeren en opnieuw installeren van SQL server, waarbij je let op het aanzetten van Windows Authenticatie en het sa wachtwoord onthoud.

Succes!

Avatar for Daniel Comment from Daniel
I followed the steps, but when I navigate to http://mySite.local/ the setup screen is shown without styles applyi, and when I click the Lets get started! link nothing happens. Any idea about this issue?

Thanks!

Avatar for Hadeeel Comment from Hadeeel
I cannot finsh with insal the program when I should typ this (127.0.0.1 mynewumbracosite.local)

Avatar for sajidriaz Comment from sajidriaz
Thank you!!!

however, when I install CWS i get no xslt. any ideas

Avatar for Sebastiaan Janssen Comment from Sebastiaan Janssen
@Daniel & Hadeeel sorry for the late reply, it might still help others:

@Daniel: Sounds like a permissions issue, be sure to check that the application pool user has permissions to modify. When the App Pool user is ApplicationPoolIdentity, I use the IIS_IUSRS group and give that permissions to modify everything in my "dev" folder and below it.

@Hadeeel: In the hosts files (as detailed above "The hosts file can be found in: C:\Windows\System32\drivers\etc")

@sajidriaz: I am guessing that the XSLT folder is not writable at the moment (see my reply above to Daniel for more info). See if you can create a new XSLT file in the developers section. If that does work then I am not sure what's going on.

Avatar for sajidriaz Comment from sajidriaz
Hi Guys, thanks for your replies.

All working excellent documentation above!!!

I was adding web application to iis.
I should have been creating website in iis.

so all good!

thanks again

Avatar for sibe havva Comment from sibe havva
very very good article !!!

thanks again !!!

Avatar for Rob Denham Comment from Rob Denham
Best installation guide for umbraco yet! Cheers for this, definitely added to favourites for future reference.

Avatar for mehek Comment from mehek
jsu wont accept my username and pass..even though i hav followed ur steps to the dot..HELP

Avatar for khalid Comment from khalid
How i can install Umbraco , i am the new user , please help what i need for it do.

Avatar for nuduto Comment from nuduto
Much better guide than an Umbraco book I've just bought.

Many thanks

Add your comment