ASP.NET Core server

Hosting a knowledge base in a subfolder seamlessly integrates documentation into your existing website structure. For example, setting up a subfolder path like /help allows users to access your knowledge base directly within your domain, such as example.document360.io/help.

To get started, ensure you replace the example domain in the configurations with your own Document360-provided domain or your custom domain.

Setting up a subfolder path

1. Install the ASP.NET Core package.

2. In the Standard.cs file, configure the method as follows:

To enable Document360 in a subfolder and route both the UI and API requests correctly, include proxy mappings for both the Subfolder path (e.g., /docs) and the Site API path (e.g., /api or /docs-api):

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    // Proxy for /docs (Subfolder path)
    app.MapWhen(ctx => ctx.Request.Path.StartsWithSegments("/docs"),
        builder => builder.RunProxy(new ProxyOptions()
        {
            Scheme = "https",
            Host = "example.document360.io"
        }));

    // Proxy for /api (Site API path - Only for KB Site 2.0)
    app.MapWhen(ctx => ctx.Request.Path.StartsWithSegments("/api"),
        builder => builder.RunProxy(new ProxyOptions()
        {
            Scheme = "https",
            Host = "example.document360.io"
        }));
}

NOTE

• If you are on KB Site 2.0 and wish to host your Knowledge base as a subfolder, you have to define the Subfolder path as well as the Site API path.

• Replace /docs and /api with the exact values configured under Subfolder path and Site API path in the Document360 portal.

What happens next?

Once you have successfully configured the web server, your knowledge base site will be live on your custom subfolder/subdirectory. However, the existing URL for your project will serve the requests.

For example, example.document360.io and example.com/docs (if /docs is your folder path) will point to the knowledge base site.

This will cause duplicate content in Search engines (Google, Bing, etc.). To do this, you will need to enable a URL redirect. Enabling a URL redirect prevents search engines like Google or Bing from indexing duplicate content, which can negatively impact your site's search rankings.

NOTE

To enable the redirect from example.document360.io to example.com/docs, please contact us at support@document360.com.