Remotely/README.md
2021-07-29 07:53:45 -07:00

35 lines
2.1 KiB
Markdown

# Remotely
A remote control and remote scripting solution, built with .NET Core and SignalR Core.
Website: https://remotely.lucency.co
Public Server: https://tryremotely.lucency.co
## Build Instructions (Windows 10)
The following steps will configure your Windows 10 machine for building the Remotely server and clients.
* Install Visual Studio 2019.
* Link: https://visualstudio.microsoft.com/downloads/
* Install the latest .NET Core SDK.
* Link: https://dotnet.microsoft.com/download
* Clone the git repository and open the solution in Visual Studio.
* Build (in Release configuration) the Remotely_Desktop and Remotely_ScreenCast projects.
* Run Publish.ps1 in the Utilities folder.
* Example: powershell -f [path]\Publish.ps1 -outdir C:\inetpub\remotely -rid win10-x86
* The output folder will now contain the server, with the clients in the Downloads folder.
* Change values in appsettings.json for your environment.
* Documentation for hosting in IIS can be found here: https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/index?view=aspnetcore-2.2
## Hosting a Server (Windows)
## Hosting a Server (Linux)
* Download and unzip the Linux server package.
* Run Remotely_Server_Setup.sh (with sudo) in the Utilities folder.
* App root will be the above output folder.
* Change values in appsettings.json for your environment.
* Documentation for hosting behind Nginx can be found here: https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/linux-nginx?view=aspnetcore-2.2
## Notes
* .NET Core has two methods of deployment: framework-dependent and self-contained.
* Framework-dependent deployments require the .NET Core runtime to be installed on the target computers. It must be the same version or higher that was used to build the app.
* Self-contained deployments have the runtime built in, so you don't need to install it on the target computers. As a result, the total file size is much larger.
* .NET Core uses runtime identifiers that are targeted when building.
* Link: https://docs.microsoft.com/en-us/dotnet/core/rid-catalog