Skip to content
Last update: February 1, 2024

Deploy on Linux

Use this guide to deploy and configure precompiled Virto Commerce Platform V3.

Prerequisites

Supported databases

Virto Commerce is built with DB agnostic architecture and supports the following databases:

  • Microsoft SQL Server 2019 or higher.
  • MySql Server 5.7 or higher.
  • PostgreSQL 12 or higher.

Install Platform

The platform can be installed:

Download precompiled binaries

To download precompiled binaries:

  1. Open the Releases section of the Virto Commerce Platform in GitHub.

  2. Find VirtoCommerce.Platform.3.x.x.zip file. This file contains the prebuilt site and can be executed without additional compilation. The source code is not included.

  3. Unpack this zip to a local directory /vc-platform-3. After that you will have the directory with Platform precompiled files.

    wget "https://github.com/VirtoCommerce/vc-platform/releases/download/3.x.x/VirtoCommerce.Platform.3.x.x.zip"

  4. Unpack the downloaded file to the local directory /vc-platform-3 using the following command: 

    unzip VirtoCommerce.Platform.3.x.x.zip -d vc-platform-3

Now you have the directory with the precompiled files of the Virto Commerce Platform.

Use Virto Commerce CLI

To use Virto Commerce CLI (vc-build):

  1. Install vc-build using the command:

    dotnet tool install -g VirtoCommerce.GlobalTool

  2. Install the Platform and the modules using the command:

    vc-build install

  3. Specify the platform version (if required) using the command:

    vc-build install -version 3.293.0

Readmore VC-Build for Packages Management

Setup Platform

To set up the Platform:

  1. Configure application strings.
  2. Run the Platform by CLI "dotnet".
  3. Perform initial sign in.

Configure application strings

To configure application strings:

  1. Open the appsettings.json file in a text editor.

  2. In the ConnectionStrings section, modify the VirtoCommerce node as follows:

        "ConnectionStrings": {
        "VirtoCommerce" : "Data Source={SQL Server URL};Initial Catalog={Database name};Persist Security Info=True;User ID={User name};Password={User password};MultipleActiveResultSets=True;Connect Timeout=30"
    },

    Note

    Make sure the user has permission to create new databases.

  3. To display images, specify the public url for assets by updating Assets:FileSystem:PublicUrl in the Assets section:

    "Assets": {
        "Provider": "FileSystem",
        "FileSystem": {
            "RootPath": "~/assets",
            "PublicUrl": "https://localhost:5001/assets/" <-- Set your platform application url with port localhost:5001
        },
    },

  4. To configure CMS content storage, specify the public url for content for content by updating Content:FileSystem:PublicUrl in the Content section: 

    "Content*": {
        "Provider": "FileSystem",
        "FileSystem": {
            "RootPath": "~/cms-content",
            "PublicUrl": "https://localhost:5001/cms-content/" <-- Set your platform application url with port localhost:5001
        },
    },

  5. Save the appsettings.json file to apply the configurations.

Run the Platform by CLI "dotnet"

To run the Platform by CLI:

  1. Install and trust HTTPS certificate. Run steps described in this article to trust the .NET Core SDK HTTPS development certificate on Linux.

    Read more about enforcing HTTPS in ASP.NET Core.

  2. Run the Platform using the following command:

    export ASPNETCORE_URLS="http://+:5000;https://+:5001"
cd vc-platform-3
dotnet VirtoCommerce.Platform.Web.dll

  3. The output in the console will say something like:

    Now listening on: http://[::]:5000
Now listening on: https://[::]:5001

Perform initial sign-in

To access the Platform and perform initial sign-in:

  1. Open your browser and type https://localhost:5001.

  2. If you encounter the Your connection is not private error, click Advanced → Proceed to.... This option allows you to proceed to the website even though the browser has detected an issue with the SSL certificate.

    Note

    For additional details on addressing this error and using a self-signed certificate, refer to Trust the ASP.NET Core HTTPS development certificate.

  3. Upon the first request, the application will create and initialize the database.

  4. Once completed, you will be redirected to the sign-in page. Use the following credentials to sign in:

    • Login: admin
    • Password: store

Your Platform is ready to go.