Skip to content

Local Development Setup

Masterjun edited this page Feb 4, 2024 · 19 revisions

Prerequisites

  • Git
  • .NET 8.0 SDK
  • Visual Studio 2022 recommended for best development experience or VS Code
  • postgres for the local database

Windows 10

1. Install Git

https://git-scm.com/download/win

2. Install .NET 8.0 SDK

https://dotnet.microsoft.com/en-us/download/dotnet/8.0

3. Install Postgresql

https://www.postgresql.org/download/windows/

  • Make sure you don't have an old version already installed
  • Use the default user postgres with a password postgres, and the default port of 5432 (if you wish to override any of these settings, override the connection string using user secrets)
  • Postgresql master password: Run pgAdmin4 and change it to postgres

3.5. Run using commandline IDE

dotnet run --project TASVideos/TASVideos.csproj --launch-profile Development

4. Install Visual Studio or VS Code

Visual Studio

  1. Install Visual Studio Community 2022 from https://visualstudio.microsoft.com/
  2. Run Visual Studio installer and select the following:
  • ASP.NET and web development
  • .NET desktop development
  1. Clone repository from https://github.com/TASVideos/tasvideos.git
  2. Open TASVideos.sln
  3. Select the following project to be built:
  • Dev (Generate Sample Data)
  • Next time Dev (Sample Data No Recreate) can be used for quicker start up times.

VS Code

  1. Install VS Code from https://code.visualstudio.com/Download
  2. Install C# extension: CTRL+SHIFT+X > C#
  3. Clone Repository: CTRL+SHIFT+G > Clone Repository > https://github.com/TASVideos/tasvideos.git
  4. Build TASVideos: CTRL+SHIFT+D > Select TASVideos (Generate Sample Data), click on green arrow to run
  • Next time TASVideos (Sample Data No Recreate) can be used for quicker start up times.

Note: If you use Chrome and Demo build, you will need to use https://localhost:5001

Ubuntu 20.04.4 LTS

1. Install Git

https://git-scm.com/download/linux

sudo apt install git

2. Install .NET 8.0 SDK

https://docs.microsoft.com/en-us/dotnet/core/install/linux-ubuntu

wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
sudo apt-get update; sudo apt-get install -y apt-transport-https && sudo apt-get update && sudo apt-get install -y dotnet-sdk-8.0

3. Install Postgresql

https://www.postgresql.org/download/linux/ubuntu/

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
sudo apt-get update
sudo apt-get -y install postgresql

4. Install VS Code

  1. Install VS Code from https://code.visualstudio.com/Download
  2. Install C# extension: CTRL+SHIFT+X > C#
  3. Clone Repository: CTRL+SHIFT+G > Clone Repository > https://github.com/TASVideos/tasvideos.git
  4. Build TASVideos: CTRL+SHIFT+D > Select TASVideos (Generate Sample Data), click on green arrow to run
  • Next time TASVideos (Sample Data No Recreate) can be used for quicker start up times.

macOS Big Sur 11.0

1. Install Git

https://git-scm.com/download/mac

2. Install .NET 8.0

https://dotnet.microsoft.com/en-us/download/dotnet/8.0

3. Install Postgresql

https://www.postgresql.org/download/macosx/

  1. Postgresql master password: Run pgAdmin4 and change it to postgres

4. Install Visual Studio or VS Code

Visual Studio

  1. Install Visual Studio Community 2022 from https://visualstudio.microsoft.com/
  2. Run Visual Studio installer
  3. Clone repository from https://github.com/TASVideos/tasvideos.git
  4. Open TASVideos.sln
  5. Select the following project to be built: TASVideos Demo

If you use Safari and Demo build, you will need to visit https://localhost:5001 and input your username and password to the appearing prompt in order to http://localhost:5000 correctly work

VS Code

https://code.visualstudio.com/docs/setup/mac

  1. Install C# extension: CMD+SHIFT+X > C#
  2. Clone Repository: CTRL+SHIFT+G > Clone Repository > https://github.com/TASVideos/tasvideos.git
  3. Build TASVideos: CMD+SHIFT+D > Select TASVideos, click on green arrow to run

Working with Sample Data

You want to use the launch profile "Generate Sample Data". This will load a sanitized sub-set of the production data as a file into a local temp folder and then run that to generate sample data. This can take some minutes. After the first successful run of this, you can switch to the profile that does not generate sample data to increase startup time.

All user's passwords are changed to Password1234!@#$ and that should be used when logging into a local instance