|
| 1 | +--- |
| 2 | +title: Launcher setup |
| 3 | +description: How to set up the Launcher, the application responsible for starting and handling Client sessions, for local development and production hosting. |
| 4 | +--- |
| 5 | + |
| 6 | + |
| 7 | +This guide details how to set up the Mercury Launcher for local development, moderation, and production publishing. More information on the Launcher is available on the [Launcher service page](/services/launcher). |
| 8 | + |
| 9 | +## Requirements |
| 10 | + |
| 11 | +You will need: |
| 12 | + |
| 13 | +- Latest version of [Git](https://git-scm.com) installed (expected as `git`, optional) |
| 14 | +- Latest version of [.NET](https://dotnet.microsoft.com) installed (expected as `dotnet`) |
| 15 | +- A terminal |
| 16 | + |
| 17 | +## Instructions |
| 18 | + |
| 19 | +{% steps %} |
| 20 | + |
| 21 | +1. Clone the [tp-link-extender/MercuryLauncher](https://github.com/tp-link-extender/MercuryLauncher) repository to a directory of your choice on your local machine, and navigate to the root directory of the repository. |
| 22 | + |
| 23 | + ```bash |
| 24 | + git clone https://github.com/tp-link-extender/MercuryLauncher |
| 25 | + cd MercuryLauncher |
| 26 | + ``` |
| 27 | + |
| 28 | + - If not using Git, you can also [download the repository as a compressed archive file](https://github.com/tp-link-extender/MercuryLauncher/archive/refs/heads/main.zip) (.zip) from the GitHub page and extract it to a directory of your choice. |
| 29 | + |
| 30 | +2. Navigate to the **Config.fs** file and modify the configuration options as desired. See the [Launcher service page](/services/launcher#configuration) for more information on the available configuration options. |
| 31 | + |
| 32 | +3. Run `dotnet run` to test the Launcher. If everything is set up correctly, the Launcher will start building. Once it is complete, it will start, immediately attempting to install the latest Setup deployment from the configured URL. It will not attempt to start the Client or Studio. |
| 33 | + |
| 34 | + - If this command is being run for the first time, a welcome message similar to the following will be printed to the console: |
| 35 | + |
| 36 | + ``` |
| 37 | + Welcome to .NET 10.0! |
| 38 | + --------------------- |
| 39 | + SDK Version: 10.0.200 |
| 40 | + |
| 41 | + Telemetry |
| 42 | + Read more about .NET CLI Tools telemetry: https://aka.ms/dotnet-cli-telemetry |
| 43 | + |
| 44 | + ---------------- |
| 45 | + Installed an ASP.NET Core HTTPS development certificate. |
| 46 | + To trust the certificate, run 'dotnet dev-certs https --trust' |
| 47 | + Learn about HTTPS: https://aka.ms/dotnet-https |
| 48 | + |
| 49 | + ---------------- |
| 50 | + Write your first app: https://aka.ms/dotnet-hello-world |
| 51 | + Find out what's new: https://aka.ms/dotnet-whats-new |
| 52 | + Explore documentation: https://aka.ms/dotnet-docs |
| 53 | + Report issues and find source on GitHub: https://github.com/dotnet/core |
| 54 | + Use 'dotnet --help' to see available commands or visit: https://aka.ms/dotnet-cli |
| 55 | + -------------------------------------------------------------------------------------- |
| 56 | + ``` |
| 57 | + |
| 58 | +4. After you have modified the source code as required and are ready to publish the launcher, run the corresponding command for the operating system you wish to publish for: |
| 59 | + |
| 60 | + - Windows: `dotnet publish --nologo -o ./out -r win-x64` |
| 61 | + - Linux: `dotnet publish --nologo -o ./out -r linux-x64` |
| 62 | + |
| 63 | + These commands will each place the published executable in the **out** directory. |
0 commit comments