Montr

R&D of B2B automation applications

• SSO
• MDM
• more to come...

Table of contents

• 🚀Getting Started
• 🧾 License

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

• .NET 7.0
• PostgreSQL
• Node.js (only for development)

Installation

1. Clone repository from git@github.com:montr/montr.git
2. Create database montr (or choose your database name) in PostgreSQL.
3. Copy sample secrets.json from templates/secrets.json to Microsoft/UserSecrets/1f5f8818-a536-4818-b963-2d3ef5dcef03 directory. Specify choosen database name and other connection string parameters in Default and Migration connections of ConnectionStrings section in secrets.json.
4. Run dotnet watch run in ./src/Host to watch backend sources changes. During first startup database structure (tables etc.) and default data (users etc.) will be created.
5. Install node packages in ./src/ui with npm install.
6. Run webpack with npm install to watch frontend sources changes in ./src/ui. Compiled assets will be copied to ./src/Host/wwwroot/assets and served from these location.
7. Open https://127.0.0.1:5001 in browser. Specify default administrator email and password on opened Setup page.

<details> <summary>Additional setup on macOS</summary>

In case of error Unable to load shared library 'libgdiplus' or one of its dependencies. when running app in macOS:

1. Install libgdiplus with brew install mono-libgdiplus
2. To fix web app link libgdiplus from install location sudo ln -s /opt/homebrew/Cellar/mono-libgdiplus/6.1/lib/libgdiplus.dylib /usr/local/share/dotnet/shared/Microsoft.NETCore.App/6.0.0
3. To fix unit tests link libgdiplus from install location sudo ln -s /opt/homebrew/Cellar/mono-libgdiplus/6.1/lib/libgdiplus.dylib /usr/local/share/dotnet/shared/Microsoft.AspNetCore.App/6.0.0

</details>

License

Montr is AGPL 3.0 licensed.