Requirements

• .NET SDK
• Bash terminal using Ubuntu for Windows or another distro available in the Microsoft Store (Windows Devs Only)

Ubuntu command line configuration (Windows only)

After you setup your Ubuntu command line on Windows (user, password, etc.), you need to setup the dotnet enviroment. On the command line, type the following commands:

~$ wget -q https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb
~$ sudo dpkg -i packages-microsoft-prod.deb

Getting the .NET SDK

Windows

Download the .Net SDK in this link or paste this in your browser https://www.microsoft.com/net/download/thank-you/dotnet-sdk-2.1.302-windows-x64-installer

Mac

Download the .Net SDK in this link or paste this in your browser https://www.microsoft.com/net/download/thank-you/dotnet-sdk-2.1.302-macos-x64-installer

Linux

Run the following commands to get the .NET SDK on the linux command line:

~$ sudo apt-get install apt-transport-https
~$ sudo apt-get update
~$ sudo apt-get install dotnet-sdk-2.1

Run migrations for the first time

1. Run the init.sh script in the root path of the project. This will run the command lines tools necessary to run migrations (Mac users may need to restart the terminal Window to detect the new changes)

2. Open the solution and compile the the Migrations project

3. On the terminal/command line, go to "Migrations/Scripts/" folder and run the up.sh script. This should have two effects:

   • Create mydb.db database file (which is a SQLite database) in the root folder
   • All Migrations should apply into the database file

Run the app for the first time

1. Make a copy of the appsettings.json.template file

2. Rename it appsettings.json

3. Fill each corresponding key value with real values from every specific service

4. Open the solution

5. Restore nuget package

6. Run