Table of Contents

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 C# extension
  5. Open up a PowerShell terminal inline in VS Code Inline terminal 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
    

    Install templates VS Code

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

    • 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. dotnet new VS Code

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: Open terminal VS Code Open terminal VS Code

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

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

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 Wizard1

  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: Files folder location

  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) sql server VS Code
    • You need to create a user (name of your choice) that has 'Server Roles' set to 'dbcreator' sql logins VS Code
    • And you need to set a password using SQL Server authentication sql logins VS Code
  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 wizard 3 VS Code Note that your credentials are saved to the 'GlobalSettings.Database.config' file located in your 'Files' folder wizard 3 VS Code

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

  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 Sign in VS Code

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
To top