Install using VS Code

How to install DynamicWeb 10 using VS Code

This article is a step-by-step guide to making a local installation of DynamicWeb 10 using Visual Studio Code, a free IDE that you can run on Windows, Mac or Linux.

Prerequisites

Before you can install DynamicWeb 10 using VS Code make sure to follow these steps:

1. Install .NET SDK 7.x
   • Tip: if you're in doubt about if your system is 32-bit (x86), 64-bit (x64) or Arm64, go to 'system information' for Windows or 'About This Mac'
2. Install SQL Server Express and SQL Server Management Studio Express (latest version, minimum v16)
   • If you're a Mac user, the setup for your database is going to be different - see here.
3. Install and launch VS Code
4. Install the C# extension
5. Open up a PowerShell terminal inline in VS Code

Install DynamicWeb Project Templates

Next install the latest version of our project templates package.

1. In the VS Code PowerShell terminal type the following (don't worry about the folder context you're in yet):

    dotnet new install Dynamicweb.ProjectTemplates
   

   

2. Select the folder where you'd like to install your solution by using the 'cd' (change directory) command

   • Tip: consider creating a folder on your C drive or Macintosh HD for local development and create a new folder for each solution you create

3. Use the terminal to create the new DynamicWeb project

    dotnet new dw10-suite -n 'Example DW10'
   

   This will make a new DynamicWeb Suite in a folder 'Example DW10'. You could also have chosen the 'dw10-cms' template. If you are already located in the directory you would like to make the solution in, for example by using the 'md' command, you could also omit the '-n' parameter.

Open and Run your DynamicWeb Project in VS Code

In VS Code, you can now open and select the folder where you've created your project:

You may get a message saying offering to add assets. Go ahead and say yes.

Run the project, with or without debugging (you can also enter 'dotnet run' in the terminal).

This will open a new browser window with your new solution and the first step of the setup guide.

Note

At this point, if you want to install a Swift (or another pre-packaged solution), you should follow the Extract the database and Extract the Files-folder steps in the Swift install guide before proceeding with the setup guide.

The Setup guide

The setup guide will help you:

• Create a new /Files-folder or map to an existing one
• Create a new database or map to an existing database

Follow the setup guide:

1. Step 1 - click Get Started

2. Step 2 - create a new /Files-folder or map to an existing one (e.g. a /Files-folder) If you let the wizard create your 'Files' folder, it will be placed in the wwwroot folder:

3. Before proceeding with the setup guide you need to ensure that your instance of MS SQL is configured:

   • Open MS SQL Server Management Studio (where you can retrieve the server name)
   • You need to create a user (name of your choice) that has 'Server Roles' set to 'dbcreator'
   • And you need to set a password using SQL Server authentication

4. Step 3 - setup your database. Choose 'Create database if it does not exist' unless you're installing Swift, in which case you should connect to the database you extracted Note that your credentials are saved to the 'GlobalSettings.Database.config' file located in your 'Files' folder

5. Step 4 and 5 - configure an administrator and click on the 'go to login' button

6. If everything is set up right, you will see the license wizard. Follow the guide and select a trial license or install a "proper" license if appropriate.

7. Sign in

Configure and code locally

Now you're ready to configure and customize as you'd like.

• You can start configuring your DynamicWeb solution through the DynamicWeb admin backend UI. Read more
• You can make frontend customizations working with templates. Read more
• You can make backend customizations working with extensibility classes. Read more