The BlogEngine.NET installation process is fairly straight forward. The information below will guide you through the process and help you with any issues you encounter. By installation, we mean that you are creating a new instance (folder with the application) of BlogEngine.NET on your server/hosting space/local PC.
Choosing a version for download
There are two download options for BlogEngine.NET:
- Web Project: This is an ideal option if you want to use BlogEngine.NET right out of the box and don't have plans to create custom controls or extend the software.
- Source Code: This is the developer option. If you are interested is seeing how things work or want to add to the functionality, this is your option. Current BlogEngine.NET built with Visual Studio 2013 (free Express version works fine).
Choosing one option over the other doesn't lock you into your decision, but you need to choose a place to start. If you are unsure, just download the web project. You can always download the Source Code later and add your changes in.
Get the web project folder
Download and unzip project files from Codplex. If you choose the Web Project download, your newly unzipped folder contains the web project you want to work with. If you download the source code, the web project is buried a little bit. The web project is found under the BlogEngine.NET folder, then the BlogEngine folder.
Load the web project on your web server
Now that you have the web project folder, copy those files and folders out to your web server. This usually involves FTP, but depending on your situation, it might even require a portable storage device (e.g. USB flash drive).
Set folder as a .NET application
Current application require ASP.NET 4.5. If you have direct IIS access, you need to create an application. If you are using a hosted provider, you need to use their control panel to make this happen. It should be a standard option, but if you don't find it, you may need to contact your hosting provider for support. BlogEngine.NET is developed under an "Integrated Mode" application pool. It is recommended your application pool be in Integrated Mode (as opposed to Classic Mode).
Add write permissions
This is an often forgotten step. If you miss it, you'll notice as soon as you try to make a change. You need to give the application write permissions as a minimum to the App_Data and Custom folders. Again, your hosting provider may have a control panel that allows you to do this. If not, you may need to contact your hosting provider for support. To support auto update, entire application directory must have write permission.
Setting write permissions could involve up to 3 steps:
- Using the IIS admin tool or your hosting provider's control panel, set the folder as "Write" capable;
- If you have direct access to the file system, make sure the account under which the BlogEngine.NET's application pool is running (typically "ASPNET" or "Network Service") has write access to the physical folder;
- After unzipping the web folder, all files have their read-only attribute enabled. Turn that attribute off.
Navigate to the web page
Ok, now you are ready to navigate to the web site and see how you did. For example, if you installed the web site to your local machine for testing, you would navigate to http://localhost/default.aspx. You can also edit the default document to display to default.aspx using the IIS MMC snap-in. If you do this, you can navigate direcly to http://localhost/ without specifying the page name. If all goes well, you are greeted by the default blog page.
Login and Setup your user name
The last step is to scroll down and find the sign in link on the right side. Click Sign in and then login in the following information.
User Name: admin Password: admin
Once you login, you will see a new menu on the right hand side. Click Users.
Create a new user for yourself. The user name you choose is your display name. See the User Administration page for more information.
Delete the admin account. You don't want everyone who reads this to be able to login to your blog, do you?
Finally, log out, then log back in using the user account you just created for yourself.
You can also watch video on how to install and configure BE 2.9, steps essentially the same.