How to create a clean .NET Project binding Umbraco and posting it on BitBucket

In this Exmaple i will show you how you create a Default MVC 4 Project. After that we will bind the Umbraco CMS including a Custom SQL Server Connection.

To round it up, we will post the Project on BitBucket as a git repository.


First, open Visual Studio and go to File -> New -> Project. Select "ASP.NET MVC 4 WEB Application" as Project type. Set your project path and project name and click ok.

After creating the empty default Web project we want to upload/connect it to a Git repository. In our case we will use BitBucket as managing Tool.


So go to and sign up. After you logged in got to Repositories --> Create Repositorie

Fill in you data. In my case, i call the repository "umbImExport". This is how i called my project too. (Right Naming will help you in the futre to understand your own code better and faster.)


now click "Create repository" to finish the wizard.


Sum up: Now you have a Default empty MVC project and a repository created on BitBucket.

to connect them open the "Git Bash"

If you dont have installed Git on your machine, please check this post.


So opend the git bash/command line just go to the directory where your project is located (like: cd /user/documents/..../MyProject)

Now typ:

  1. $ git init
  2. $ git add .
  3. $ git commit -m 'initial commit of full repository'



Now got to BitBucket and select your Repo you want to use (which is yet empty)


you can skip the first "cd" command if you are already in the right folder

so type the following 3 rows in your command line to push your code to your BitBucket repository.


Gratulation: you build connect your project successfully with a Git Repository.

Now we have a Backup/Clone we can install Umbraco.


We will install Umbraco using the NuGet Package Manager. 

Go back to Visual Studio. Tools --> NuGet Package Manager --> Package Manager Console.

Type in 

you should see something like this

and after successfull installation:

After installing Umbraco you have to configure it up.

For this just Run your Project 


For me it's very important to bind the SQL connection right from the beginng to not get any trouble later.

So i prefer directly to create a SQL Server database on my online server. i dont like to copy databases.

So before you continue to configure your Umbraco project, create a new SQL database on your machine (in my case, directly the online server)

named it as you want - Remeber again: naming -  so, i call my database "umbImExport"

Now we have a empy database. Go back to to your browser and fill your data

click Customize if you bind your project to your custome database. 

now fill in your connection information. and click continue

as last step you can select a template / "Umbraco Starter Kit" if you want. i will not need one so i check

"No thanks"

If everything works like expected you should now successfully installed Umbraco to your new Project.

Congratulation: you installed Umbraco: you can reach your Umbraco backoffice by running your project. and append "/umbraco" to the url's end. like "http://localhost:4711/umbraco"

you should see the login form here.


pass in your data which you set at the beginning of this umbraco configuration. After a successfull logging you should see your Umbraco Backend. In this exmaple its the Version 7.3


As last step we now "check out" our changes to the BitBucket Repository.

To do this, go to Visual Studio, open "Team Explorer" and select changes:

Now fill in your "commit-description" and press "Commit and Publish" ( find the button under "Commit")

after uploading the changes: 


To see your result, you can now check your BitBucket. It should show your 2 commits. the one we did after creating the empty MVC project and the second after installing the Umbraco CMS to our project.








If you like it, dont forget to share. 



Caglar Tasci

Beauty is more important in computing than anywhere else in technology because software is so complicated. Beauty is the ultimate defence against complexity. — David Gelernter

comments powered by Disqus