MaintDockDocumentation

DocumentationChapter 03 of 14

03Requirements

Server

ItemWhat you need
Operating systemWindows Server 2019 or later (with IIS), Ubuntu 22.04 or later (or another Linux that runs .NET 10), or any Docker host.
CPU and memory2 CPU cores and 4 GB of memory for up to about 50 users.
.NET runtimeWindows with IIS: the .NET 10 Hosting Bundle. Linux: the ASP.NET Core Runtime 10.0. Docker: nothing, because the image includes it.
DatabaseSQL Server 2019 or later (the free Express edition works), Azure SQL, PostgreSQL 14 or later, or SQLite. For SQL Server and PostgreSQL, you need an empty database and a database user that can create tables in it. SQLite is built into MaintDock, so there is nothing to install. See Choose a database.
Web addressA web address such as https://maint.yourcompany.com, with an HTTPS certificate. Phones need HTTPS to use the camera for QR codes.
WebSocketsWebSockets must be allowed between the browser and the server. MaintDock uses Blazor Server, which keeps a live connection to each open page.
Email (optional)An SMTP mail server, for notifications, invitations, password links, and purchase orders to vendors. MaintDock works without email, but then it shows notifications only in the app.

The .NET downloads are at dotnet.microsoft.com/download/dotnet/10.0.

Browsers

Use a current version of Chrome, Edge, Firefox, or Safari. On phones, use Safari on an iPhone or Chrome on Android. JavaScript must be turned on.

To change the code

  • The .NET 10 SDK.
  • A code editor that supports .NET 10, for example Visual Studio, Visual Studio Code, or JetBrains Rider.
  • SQLite (built in), PostgreSQL, or SQL Server for development.
  • The dotnet-ef tool, only if you change the database tables.