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:
- 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'
- 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.
- Install and launch VS Code
- Install the C# extension
- Open up a PowerShell terminal inline in VS Code
Install DynamicWeb Project Templates
Next install the latest version of our project templates package.
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
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
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:
Step 1 - click Get Started
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:
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
- Open MS SQL Server Management Studio (where you can retrieve the server name)
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
Step 4 and 5 - configure an administrator and click on the 'go to login' button
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.
Sign in
Configure and code locally
Now you're ready to configure and customize as you'd like.