Coding with Bob: Building an Episerver Site from Scratch - Part 1
While most new Optimizely + Episerver developers tend to learn on the job through maintenance projects, Blend believes that there's a lot of value in learning how to spin a site up from scratch. Blend's Director of Development Bob Davidson provides some guidance on how to do just that in this Coding with Bob video.
- Bob Davidson
- Jul. 01 2021
It's common for developers who are new to Episerver to learn on the job. Frequently they start out doing maintenance on existing projects. They cut their teeth on projects that have already been configured and architected. While this may ease the learning curve (and ensure new projects are set up to team standards), it can leave gaps in knowledge. A developer may learn about content modeling, scheduled jobs, views, and other items that require frequent updates and bugfixes, but might not receive much exposure to lower level concepts such as how content rendering works. The line between Episerver and MVC may be blurry. Much of the system may feel like voodoo.
I think it's useful to build at least one Episerver site from nothing, using (almost) no frameworks, going through each step manually and really understanding what's happening at each point. It's helpful to take the time to understand all of the black magic in the boilerplate code we seem to see in project after project.
To that end, I've started a video series walking through creating a new Episerver site from scratch. The first step, setting up a new, blank Episerver project is documented in the quick video below:
Below is a summary of the steps covered in the video:
Create the Solution and Project
1. Create a new Solution.
2. Using the Episerver Add-On, create a new Episerver site. Use the
Empty template. For our purposes, do not install the Alloy content and code.
Create the Database
By default, the site will be configured to create a Local DB in your
AppData directory. Generally, it's preferable to create an empty database in an actual SQL Server instance.
- In the
.\packages\EPiServer.CMS.Core.11.15.1\toolsfolder, you'll find the
EPiServer.Cms.Core.sqlfile. (Note: the actual version number in the path,
11.15.1, will likely be different for you. Just look for the newest
EPiServer.CMS.Corefolder). You'll need this file.
- Create a new, blank database within SQL Server:
CREATE DATABASE EpiserverExample;. Name the database (
EpiserverExamplehere) whatever you prefer.
- Run the
EPiServer.Cms.Core.sqlfile against your new database.
- Update your connection string for the database. It will look something like :
<add name="EPiServerDB" connectionString="Data Source=.;Initial Catalog=EpiserverExample;Connection Timeout=60;Integrated Security=True;MultipleActiveResultSets=True" providerName="System.Data.SqlClient" />.
Data Sourceshould be your local SQL Server instance.
Initial Catalogis whatever you named your database.
Integrated Security=Trueworks for me because I'm running IIS Express and my Windows account has full access to the database. Otherwise, you may need to create a SQL login/user and grant it access to the database.
MultipleActiveResultSets=Trueis required for Episerver to run correctly. Do not forget this.
Launch the site
The first time you launch the site, you will get a
Resource cannot be found 404 error. This is expected. There is no homepage yet, so it makes sense it cannot be found.
/Episerver, you should see a login page. There, if you're using a standard
Windows account, you should be able to log in. This is because by default, the site configured for Multiplexing authentication with ASP.NET Membership. While that's convenient, I would recommend removing it in favor of Identity Framework. But that's a future blog post.