Minecraft-Console-Client/docs/guide/installation.md

---
title: Installation
---

# Installation

- [Quick Install (one-liner)](#quick-install)
- [YouTube Tutorials](#youtube-tutorials)
- [Download a compiled binary](#download-a-compiled-binary)
- [Building from the source code](#building-from-the-source-code)
- [Run using Docker](#using-docker)
- [Run on Android](#run-on-android)
- [Run MCC 24/7 on a VPS](#run-on-a-vps)

## Quick Install

The quickest way to get MCC is to run the installer script for your platform. It auto-detects your OS and CPU architecture, fetches the latest release from GitHub, and saves the binary to your current directory.

### Linux / macOS

Open a terminal in the folder where you want MCC and run:

```bash
curl -fsSL https://mccteam.github.io/install.sh | sh
```

If you prefer `wget`:

```bash
wget -qO- https://mccteam.github.io/install.sh | sh
```

The script downloads `MinecraftClient` and marks it executable. Supported architectures: `x64`, `arm64`, `arm` (Linux only).

### Windows

Open **PowerShell** in the folder where you want MCC and run:

```powershell
iwr -useb https://mccteam.github.io/install.ps1 | iex
```

The script downloads `MinecraftClient.exe`. Supported architectures: `x64`, `x86`, `arm64`.

::: tip
You can also download the scripts directly and inspect them before running:
- Linux/macOS: [install.sh](https://mccteam.github.io/install.sh)
- Windows: [install.ps1](https://mccteam.github.io/install.ps1)
:::

## YouTube Tutorials

If you're not the kind of person that likes textual tutorials, our community has made video tutorials available on YouTube.

- [Installation on Windows by Daenges](https://www.youtube.com/watch?v=BkCqOCa2uQw)
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)

## Download a compiled binary

You can download a compiled binary of the latest build from the [GitHub Releases](https://github.com/MCCTeam/Minecraft-Console-Client/releases) page.

## Building from the source code

We recommend you to download our precompiled binary file from [GitHub](https://github.com/MCCTeam/Minecraft-Console-Client/releases).

However, if you want to build the program from source code, please follow the guide.

### Windows

<details>
<summary>Windows build instructions</summary>

Requirements:

- [Git](https://www.git-scm.com/)
- [.NET 10 SDK](https://dotnet.microsoft.com/en-us/download) or [Visual Studio](https://visualstudio.microsoft.com/) configured for C# app development

::: note
If you want to modify the code and you are new to C# or programming in general, the tutorials listed in [Creating Bots](creating-bots.md#requirements) are a good starting point.
:::

#### Cloning using Git

Install [Git](https://www.git-scm.com/)

1. Make a new folder where you want to keep the source code
2. Then open it up, hold `SHIFT` and do a `right-click` on the empty white space in the folder
3. Click on `Git Bash Here` in the context menu
4. Clone the [GitHub repository](https://github.com/MCCTeam/Minecraft-Console-Client) by running:

```bash
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
```

If you cloned the repository without `--recursive`, run:

```bash
git submodule update --init --recursive
```

5. Once the repository has been cloned, you can close the `Git Bash` terminal emulator
6. Open up the new cloned folder

#### Download translation resources (optional)

01. Visit [MCC project's homepage on Crowdin](https://crowdin.com/project/minecraft-console-client).
02. You will need to log in to your Crowdin account in order to download.
03. Click on the language you want to download the translation for.
04. Find `MinecraftClient` -> `Resources` -> `Translations` -> `MCC in-app text`
05. Click the button `•••` at the end of the line.
06. Click Download and save the file to folder `/MinecraftClient/Resources/Translations/`.
07. Find `MinecraftClient` -> `Resources` -> `ConfigComments` -> `Comments in the settings file`
08. Click the button `•••` at the end of the line.
09. Click Download and save the file to folder `/MinecraftClient/Resources/ConfigComments/`.
10. Find `MinecraftClient` -> `Resources` -> `AsciiArt` -> `ASCII Arts (Please use fixed-width fonts for editing)`
11. Click the button `•••` at the end of the line.
12. Click Download and save the file to folder `/MinecraftClient/Resources/AsciiArt/`.
13. If you need to download a translation in another language, go to step 3 to continue.

#### Building using the Visual Studio

1. Open up the `MinecraftClient.sln` via Visual Studio
2. Right click on `MinecraftClient` solution in the `Solution Explorer`
3. Click on `Properties`
4. Open up the `Build` tab and select configuration `Release`
5. Press `CTRL + S` and close the file
6. Right click on `MinecraftClient` solution in the `Solution Explorer`
7. Click `Build`

If the build succeeds, the published binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net10.0/win-x64/publish/`.

#### Building using .NET manually without Visual Studio

<div class="custom-container tip"><p class="custom-container-title">Tip</p>

If you are following the AI-assisted repo workflow, use WSL or another Unix-style shell and prefer `source tools/mcc-env.sh` followed by `mcc-build`. That path keeps MCC's session and temp-build helpers enabled. The `dotnet` commands below are the low-level manual fallback.

</div>

1. Open the `Minecraft-Console-Client` folder you've cloned or downloaded
2. Open the PowerShell (`Right-Click` on the whitespace and click `Open PowerShell`, or in Windows Explorer: `File -> Open PowerShell`)
3. Install the .NET 10 SDK if you do not already have it. The easiest current option on Windows is:

```powershell
winget install Microsoft.DotNet.SDK.10
```

4. Run the following command for a normal local build:

```bash
dotnet build MinecraftClient.sln -c Release
```

5. If you want a release-like published binary that matches the repo's CI workflow, run:

```bash
source tools/mcc-env.sh
mcc-publish --rid win-x64
```

6. Verify the SDK installation if needed:

```bash
dotnet --info
```

If the publish step succeeds, the published binary `MinecraftClient.exe` will be in `MinecraftClient/bin/Release/net10.0/win-x64/publish/`.

</details>

### Linux, macOS

<details>
<summary>Linux and macOS build instructions</summary>

<div class="custom-container note"><p class="custom-container-title">Note</p>

**If you're using Linux we will assume that you should be able to install git on your own. If you don't know how, search it up for your distribution, it should be easy. (Debian based distros: `apt install git`, Arch based: `pacman -S git`)**

</div>

Requirements:

- Git

  - Linux:

  - [Install Git on macOS](https://git-scm.com/download/mac)

- .NET 10 SDK

  - [Install .NET on Linux](https://learn.microsoft.com/en-us/dotnet/core/install/linux)
  - [Install .NET on Ubuntu](https://learn.microsoft.com/en-us/dotnet/core/install/linux-ubuntu-install)
  - [Install .NET on macOS](https://learn.microsoft.com/en-us/dotnet/core/install/macos)

#### Cloning using Git

1. Open up a terminal emulator and navigate to the folder where you will store the MCC
2. Recursively clone the [GitHub repository](https://github.com/MCCTeam/Minecraft-Console-Client) by running:

```bash
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
```

3. Go to the folder you've cloned (should be `Minecraft-Console-Client`)

4. Install the .NET 10 SDK.

   - On Ubuntu 24.04 LTS, use the built-in Ubuntu package feeds:

     ```bash
     sudo apt-get update && \
       sudo apt-get install -y dotnet-sdk-10.0
     ```

   - On macOS, the normal path is to use the official installer from the [.NET download page](https://dotnet.microsoft.com/en-us/download). Pick `Arm64` for Apple Silicon and `x64` for Intel Macs.

5. If you want to download translation resources, please check out [Download translation resources](#download-translation-resources-optional)

6. For the repo's normal local development workflow, source the helper environment and build through `mcc-build`:

   ```bash
   source tools/mcc-env.sh
   mcc-build
   ```

7. If you specifically want the low-level manual .NET command instead of the MCC wrapper, run:

   ```bash
   dotnet build MinecraftClient.sln -c Release
   ```

8. Run the following command if you want a release-like published binary that matches the repo's CI workflow:

   - On Linux:

     ```bash
     source tools/mcc-env.sh
     mcc-publish --rid linux-x64
     ```

     <div class="custom-container note"><p class="custom-container-title">Note</p>

     **If you are using Linux on ARM, 32-bit, RHEL-based distributions, or Musl, [pick the appropriate RID](https://learn.microsoft.com/en-us/dotnet/core/rid-catalog#linux-rids) for your platform and replace `-r linux-x64` with it, for example `-r linux-arm64`.**

     </div>

   - On macOS:

     ```bash
     source tools/mcc-env.sh
     mcc-publish --rid osx-x64
     ```

     <div class="custom-container note"><p class="custom-container-title">Note</p>

     **If you are not using an Intel Mac, [pick the appropriate RID](https://learn.microsoft.com/en-us/dotnet/core/rid-catalog#macos-rids) for your processor and replace `-r osx-x64` with it, for example `-r osx-arm64`.**

     </div>

If the build has succeeded, the compiled binary `MinecraftClient` will be in:

- Linux: `MinecraftClient/bin/Release/net10.0/linux-x64/publish/`
- macOS: `MinecraftClient/bin/Release/net10.0/osx-x64/publish/`

You can verify the SDK installation with:

```bash
dotnet --info
```

</details>

## Using Docker

<details>
<summary>Docker setup and usage</summary>

Requirements:

- Git
- Docker

<div class="custom-container note"><p class="custom-container-title">Note</p>

**This section is for more advanced users, if you do not know how to install git or docker, you can take a look at other sections for Git, and search on how to install Docker on your system.**

</div>

<div class="custom-container warning"><p class="custom-container-title">Warning</p>

**Docker works, but you need to start the container in interactive mode. Starting it in headless mode can still crash MCC.**

</div>

1. Clone the [GitHub repository](https://github.com/MCCTeam/Minecraft-Console-Client) by running:

```bash
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
```

2. Navigate to `Minecraft-Console-Client/Docker`
3. Build the image using the following command

```bash
docker build -t minecraft-console-client:latest .
```

**Start the container using Docker:**

<div class="custom-container danger"><p class="custom-container-title">Danger</p>

**Because of a ConsoleInteractive issue, starting the container in headless mode can crash MCC. Start it with the interactive command below, then detach with `CTRL + P` followed by `CTRL + Q` if you want to leave it running in the background.**

</div>

```bash
# You can omit -v if you do not want a mounted volume. Keeping the volume makes it much easier to edit the TOML config stored in MinecraftClient.ini from the host.
docker run -it -v <PATH_ON_YOUR_MACHINE_TO_MOUNT>:/opt/data minecraft-console-client:latest
```

Now you could login and the Client is running.

To detach from the Client but still keep it running in the Background press: `CTRL + P` and then after `CTRL + Q`.

To reattach use the `docker attach` command.

**Start the container using docker-compose:**

By default, the volume of the container gets mapped into a new folder named `data` in the same folder the `docker-compose.yml` is stored.

If you don't want to map a volume, you have to comment out or delete the entire volumes section:

```yml
#volumes:
#- './data:/opt/data'
```

Make sure you are in the directory the `docker-compose.yml` is stored before you attempt to start. If you do so, you can start the container:

```bash
docker-compose run MCC
```

Remember to remove the container after usage:

```bash
docker-compose down
```

If you use `MinecraftClient.ini` and entered your data there, you can start your container using

```bash
docker-compose up
docker-compose up -d # for daemonized background running
```

Note that you won't be able to interact with the client using `docker-compose up`. If you want that functionality, please use the first method: `docker-compose run MCC`.

As above, you can stop and remove the container using

```bash
docker-compose down
```

</details>

## Run on Android

It is possible to run Minecraft Console Client on Android through Termux and Ubuntu, but it requires a manual setup, so be careful not to skip any steps. Depending on your technical background, internet speed, and device speed, this can take anywhere from 10 to 20 minutes or more.

<div class="custom-container note"><p class="custom-container-title">Note</p>

**This section gets a bit technical. If you run into issues, open a discussion on our GitHub repository page, or ask us on our Discord server.**

</div>

<div class="custom-container note"><p class="custom-container-title">Note</p>

**You're required to have some bare basic knowledge of Linux, if you do not know anything about it, watch [this video](https://www.youtube.com/watch?v=SkB-eRCzWIU) to get familiar with basic commands.**

</div>

<div class="custom-container note"><p class="custom-container-title">Note</p>

**Here we're installing everything on the root account for simplicity sake, if you want to make a user account, make sure you update the command which reference the `/root` directory with your home directory.**

</div>

### Installation

<details>
<summary>Android installation steps (Termux + Ubuntu + .NET + MCC)</summary>

#### Termux

<div class="custom-container warning"><p class="custom-container-title">Warning</p>

**The Play Store version of Termux is outdated and not supported. Install Termux from [F-Droid](https://f-droid.org/packages/com.termux/) (recommended) or from the [GitHub releases page](https://github.com/termux/termux-app/releases/latest/).**

</div>

**F-Droid (recommended):** Install the [F-Droid](https://f-droid.org/) app store, search for "Termux", and install it.

**GitHub releases:** Go to [the latest Termux GitHub release](https://github.com/termux/termux-app/releases/latest/), download the APK file whose name contains `universal` (e.g. `termux-app_v...-debug_universal.apk`), and install it.

<div class="custom-container note"><p class="custom-container-title">Note</p>

**If your file manager does not let you install APK files, install and use `File Manager +` and grant it permission to install third-party applications when asked.**

</div>

<div class="custom-container danger"><p class="custom-container-title">Warning</p>

**Once you have installed Termux, open it, pull down the Android notification drawer, find the Termux notification, and expand it (swipe down on the notification) until you see `Exit | Acquire wakelock`. Tap `Acquire wakelock` and allow Termux to bypass battery optimization when prompted. Skipping this step may cause Termux to be killed by Android when running in the background.**

</div>

#### Installing Ubuntu

We use `proot-distro`, an official Termux utility, to install Ubuntu. It will install the latest Ubuntu LTS release available for your device architecture.

Open Termux and run the following commands one at a time, in order:

1. `pkg update -y`
2. `pkg upgrade -y`
3. `pkg install proot-distro -y`

<div class="custom-container note"><p class="custom-container-title">Note</p>

**If you are asked to press Y/N during the update or upgrade step, enter Y and press Enter.**

</div>

Now install Ubuntu:

```bash
pd install ubuntu:26.04
```

Once the installation finishes, start Ubuntu with:

```bash
pd login ubuntu
```

<div class="custom-container note"><p class="custom-container-title">Note</p>

**Every time you open Termux after it has been closed, run this command to get back into Ubuntu.**

</div>

#### Installing .NET

First, update the Ubuntu package lists and install a few dependencies and tools:

```bash
apt update && apt upgrade -y && apt install -y dotnet-sdk-10.0 wget curl nano
```

#### Installing MCC

Now we can install MCC.

Let's make a folder where MCC will be stored:

```bash
mkdir MinecraftConsoleClient
cd MinecraftConsoleClient
```

Download the latest MCC binary for ARM (the script auto detects the platform):

```bash
wget -qO- https://mccteam.github.io/install.sh | sh
```

Now you can run the MCC with this command:

```bash
./MinecraftClient
```

#### Running MCC

When you open Termux next time, start Ubuntu with:

```bash
pd login ubuntu
```

Then enter the folder you made `cd MinecraftConsoleClient` (If you named it different, use that name).

Then run MCC with: `./MinecraftClient`

To stop MCC from running you can press: `CTRL + C`

To edit the configuration/settings, you need a text editor, we recommend Nano, as it's very simple to use.

<div class="custom-container note"><p class="custom-container-title">Note</p>

**If you do not know how to use Nano, watch this [YouTube tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A).**

</div>

For downloading files, you can use the `wget` file we have installed, simply run:

`wget your_link_here` (you have examples above, and a video tutorial down bellow).

Also, here are some linux tutorials for people who are new to it:

- [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
- [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
- [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
- [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)

</details>

## Run on a VPS

<div class="custom-container note"><p class="custom-container-title">Note</p>

**This is a newer section. If you spot a mistake, please report it by opening an issue in our [GitHub repository](https://github.com/MCCTeam/Minecraft-Console-Client).**

</div>

The **Minecraft Console Client** can be run on a VPS 24 hours, 7 days a week.

- [What is a VPS?](#what-is-a-vps)
- [Prerequisites](#prerequisites)
- [Where to get a VPS](#where-to-get-a-vps)
- [Initial Amazon VPS setup](#initial-amazon-vps-setup)
- [Initial VPS setup](#initial-vps-setup)
- [Creating a new user account](#creating-a-new-user)
- [Installing .NET Core 6](#installing-net-core-6)
- [Installing the Minecraft Console Client](#installing-mcc-on-a-vps)

### What is a VPS?

VPS stands for a **V**irtual **P**rivate **S**erver, it's basically a remote virtual PC that is running in the cloud, 24 hours a day, 7 days in week. To be precise, it's a virtual machine that runs on top of a host operating system (eg. Proxmox).

You can use a VPS for hosting a website, or a an app, or a game server, or your own VPN, or the Minecraft Console Client.

Here is a [YouTube video](https://youtu.be/42fwh_1KP_o) that explains it in more detail if you are interested.

### Prerequisites

1. Git Bash (if you are on Windows)

   Download and install [Git Bash](https://git-scm.com/downloads).

   <div class="custom-container note"><p class="custom-container-title">Note</p>

   **Make sure to allow the installation to add it to the context menu**

   </div>

2. `ssh` and `ssh-keygen` commands (on Windows they are available with Git Bash; on macOS and Linux they should be available by default. If not, install them first.)

3. Basic knowledge of Linux shell commands, terminal emulator usage, SSH and Nano editor.

   If you already know this, feel free to skip.

   if you get stuck, watch those tutorials.

   If you're new to this, you can learn about it here:

   - [What is Linux? by Bennett Bytes](https://www.youtube.com/watch?v=JsWQUOEL0N8)
   - [Linux Terminal Introduction by ExplainingComputers](https://www.youtube.com/watch?v=SkB-eRCzWIU)
   - [Linux Crash Course - nano (command-line text editor) by Learn Linux TV](https://www.youtube.com/watch?v=DLeATFgGM-A)
   - [Linux Crash Course - The wget Command by Learn Linux TV](https://www.youtube.com/watch?v=F80Z5qd2b_4)
   - [Linux Basics: How to Untar and Unzip Files (tar, gzip) by webpwnized](https://www.youtube.com/watch?v=1DF0dTscHHs)

### Where to get a VPS

<details>
<summary>VPS providers and pricing</summary>

You have 2 options:

- [Buying a VPS](#buying-a-vps)
- [Getting an AWS EC2 VPS for free (12 months free trial)](#aws-ec2-vps)

#### Buying a VPS

If you do not want to give your info to Amazon or don't have a debit card, you can buy your own VPS.

**What hardware requirements I need for running the MCC?**

The MCC is not expensive to run, so it can run on basically any hardware, you do not need to spend a lot of money on a VPS if you are going to run just the MCC, go with the cheapest option.

**Where to buy a VPS?**

<div class="custom-container danger"><p class="custom-container-title">Danger</p>

**In this tutorial we will be using `Ubuntu 24.04 LTS`, so pick that family when choosing your VPS image.**

</div>

Some of the reliable and cheap hosting providers (sorted for price/performance):

- [E-Trail](https://e-trail.net/vps)

  **Minimum price**: `2.50 EUR / month`

  <div class="custom-container note"><p class="custom-container-title">Note</p>

  **If Ubuntu 24.04 LTS is not in the dropdown when ordering, you may need to reinstall later or ask support to do it.**

  </div>

- [OVH Cloud](https://www.ovhcloud.com/de/vps/)

  **Minimum price**: `3.57 EUR / month`

- [Hetzner Cloud](https://www.hetzner.com/cloud)

  **Minimum price**: `4.51 EUR / month`

- [Digital Ocean](https://www.digitalocean.com/pricing/droplets)

  **Minimum price**: `4 EUR / month`

- [Contabo](https://contabo.com/en/vps/)

  **Minimum price**: `7 EUR / month`

  **More serious VPS able to host multiple applications, 4 CPU cores and 8 GB of RAM, 200 GB SSD**

You also may want to search for better deals.

#### AWS EC2 VPS

<div class="custom-container danger"><p class="custom-container-title">Danger</p>

**This will require you to have a valid debit card that can be used on internet and a mobile phone number, as well as giving that info to Amazon corporation.**

</div>

<div class="custom-container warning"><p class="custom-container-title">Warning</p>

**Scammers often get AWS VPS and use it to mass login on to stolen Microsoft accounts, some AWS IP addresses might be blocked by Microsoft because of that, if so, you might need to switch regions or to use a Proxy. To debug if your IP has been banned by Microsoft, use the `ping <ip>` and `traceroute <ip>` commands.**

</div>

<div class="custom-container warning"><p class="custom-container-title">Warning</p>

**Related to the warning above, if you have issues logging with Microsoft and you're not banned, you may want to check the Security center on your account and approve the login from the VPS, this can be the case for some users.**

</div>

<div class="custom-container note"><p class="custom-container-title">Note</p>

**If you're not banned, sometimes fetching the keys can take some time, try giving it a minute or two, if it still hangs, hit some keys to refresh the screen, or try restarting and running again. If it still happens, use tmux instead of screen.**

</div>

Register on AWS and enter all of your billing info and a phone number.

Once you're done, you can continue to [Setting up the Amazon VPS](#setting-up-an-aws-vps).

</details>

### Initial Amazon VPS setup

<details>
<summary>AWS EC2 setup steps</summary>

<div class="custom-container note"><p class="custom-container-title">Note</p>

**Skip this section if you're not using AWS. Go to [Initial VPS setup](#initial-vps-setup)**

</div>

When you register and open the `AWS Console`, click on the Search field on the top of the page and search for: `EC2`

<div class="custom-container note"><p class="custom-container-title">Note</p>

**Make sure to select the region closest to you for the minimal latency**

</div>

Click on the **Launch instance** button.

Fill out the `Name` field with a name of your preference.

![VPS Name](/images/guide/VPS_Name.png)

For the **Application and OS images** select the current `Ubuntu Server 24.04 LTS` image. The exact AWS label may vary slightly by point release.

<div class="custom-container danger"><p class="custom-container-title">Danger</p>

**Make sure that it has `Free tier eligible` next to it.**

</div>

![VPS Select OS](/images/guide/VPS_SelectOS.png)

For the **Instance type** select `t2.micro`.

For the **Key pair (login)** click on **Create new key pair** and name it `VpsRoot`, leave the rest of settings as default and click **Create key pair**, this will generate a RSA private key that will be automatically downloaded.

<div class="custom-container danger"><p class="custom-container-title">Danger</p>

**Make sure that you save this file in a safe place and do not loose it, it's of an upmost importance since it's used to access the root/admin account of the VPS. Without it you will not be able to access the root account of the VPS! Also do not let it fall into wrong hands.**

</div>

![VPS Instance Type](/images/guide/VPS_InstanceType.png)

For the **Network settings** check the following checkboxes on:

- `Allow SSH traffic from` (Anywhere)
- `Allow HTTPs traffic from the internet`
- `Allow HTTP traffic from the internet`

<div class="custom-container note"><p class="custom-container-title">Note</p>

**The SSH traffic from Anywhere is not the best thing for security, you might want to enter IP addresses of your devices from which you want to access the VPS manually.**

</div>

![VPS Network Settings](/images/guide/VPS_NetworkSettings.png)

For the **Storage** enter `30`.

![VPS Configure Storage](/images/guide/VPS_ConfigureStorage.png)

Finally, review the **Summary** confirm that everything is as in the tutorial and that you will not be charged and click on the **Launch instance**. Once you've clicked on the button, it will take a couple of minutes for the instance to be available up and running.

Once the instance is up and running, go to it's details and copy the `Public DNS v4 IP`.

You now need to login, go to your folder where you keep the private key you've generated and downloaded (make sure you make a new folder for it, do not keep in the downloads folder) and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).

In order to login with SSH, you are going to use the following command:

```bash
ssh -i <name of your private root key here> ubuntu@<your public dns v4 ip here>
```

<div class="custom-container note"><p class="custom-container-title">Note</p>

**`<` and `>` are not typed, that is just a notation for a placeholder!**

</div>

<div class="custom-container note"><p class="custom-container-title">Note</p>

**`ubuntu` is a default root account username for Ubuntu on AWS!**

</div>

Example:

```bash
ssh -i VpsRoot.pem ubuntu@ec2-3-71-108-69.eu-central-1.compute.amazonaws.com
```

If you've provided the right info you should get `Welcome to Ubuntu 20.04.5 LTS` message.

Now you can continue to [Creating a new user](#creating-a-new-user)

</details>

### Initial VPS setup

<details>
<summary>Non-AWS VPS login steps</summary>

<div class="custom-container note"><p class="custom-container-title">Note</p>

**This section if for those who do not use AWS, if you use AWS skip it**

</div>

When you order the VPS, most likely you will be asked to provide the root account name and password, if it is the case, name the account as `root` and give it a password of your choice.

Other option is that you will get your login info in the email once the setup is done.

Once you have the root login account info, you need [Git Bash](https://git-scm.com/downloads) on Windows and `ssh` on macOS or Linux.

If you're on Windows open `Git Bash`, on mac OS and Linux open a `Terminal` and type the following command:

```bash
ssh <username>@<ip>
```

<div class="custom-container note"><p class="custom-container-title">Note</p>

**If you're given a custom port other than `22` by your host, you should add `-p <port here>` before the username (eg. `ssh -p <port here> <username>@<ip>`) or `:<port>` after the ip (eg. `ssh <username>@<ip>:<port>`)**

</div>

Example:

```bash
ssh root@142.26.73.14
```

Example with port:

```bash
ssh -p 2233 root@142.26.73.14
```

Once you've logged in you should see a Linux prompt and a welcome message if there is one set by your provider.

</details>

### Creating a new user

<details>
<summary>User account and SSH key setup</summary>

Once you've logged in to your VPS you need to create a new user and give it SSH access.

In this tutorial we will be using `mcc` as a name for the user account that will be running the MCC.

<div class="custom-container note"><p class="custom-container-title">Note</p>

**You may be wondering why we're creating a separate user account and making it be accessible over SSH only. This is for security reasons, if you do not want to do this, you're free to skip it, but be careful.**

</div>

To create a new user named `mcc` execute the following command:

```bash
sudo useradd mcc -m
```

Now we need to give it a password, execute the following command, type the password and confirm it:

```bash
sudo passwd mcc
```

<div class="custom-container note"><p class="custom-container-title">Note</p>

**When you're typing a password it will not be displayed on the screen, but you're typing it for real.**

</div>

<div class="custom-container note"><p class="custom-container-title">Note</p>

**Make sure you have a strong password!**

</div>

Now we need to give our user account the admin permissions:

```bash
sudo usermod -aG sudo mcc
```

Now we are going to set it's shell to bash:

```bash
sudo chsh mcc -s /bin/bash
```

Now we need to log in as the `mcc` user:

```bash
su mcc
```

Fill in your password when asked.

Navigate to the `mcc` user home directory with:

```bash
cd ~
```

Make a new `.ssh` directory:

```bash
mkdir .ssh
```

Enter it with:

```bash
cd .ssh
```

Make a new empty file named `authorized_keys`:

```bash
touch authorized_keys
```

Do no close the Git bash/Terminal emulator.

On your PC, make a new folder where you are going to store your SSH keys that you're going to use to log in to the user account.

Open the folder, and right click on the empty white space (not on files), if you're on Windows click **Git Bash here**, on mac OS and Linux click on **Open Terminal** (or whatever it is called).

Type the following command:

```bash
ssh-keygen -t RSA -b 4096
```

Enter the name of the key file to be: `MCC_Key`, press Enter.

When asked for a `passphrase`, enter a password of your choice and confirm it, make sure it's strong and that you remember it, best if you write it down on a piece of paper.

This will generate a private and a public key that you will use to log in to the VPS as a user that you've created.

Now open the `MCC_Key.pub` file with a text editor of your choice and copy it's contents to the clipboard.

Return to the Git Bash/Terminal emulator and execute the following command:

```bash
sudo apt install nano -y
```

This will install the Nano editor on your VPS.

Now we need to let the SSH service on your VPS know about your newly generated SSH key pair.

Make sure you are in the `/home/mcc/.ssh` folder, you can confirm this by executing:

```bash
pwd
```

If it does not print `/home/mcc/.ssh`, navigate to it with:

```bash
cd /home/mcc/.ssh
```

Now you need to open the `authorized_keys` file with the nano editor:

```bash
nano authorized_keys
```

Now paste the copied contents of the `MCC_Key.pub` into the nano editor by right clicking on it.

Save the file with `CTRL + O`, press Enter, and then exit it with `CTRL + X`.

Now we need to configure the SSHD service to let us login with the SSH key we have generated, for this we need to edit the `/etc/ssh/sshd_config` file with nano:

```bash
sudo nano /etc/ssh/sshd_config
```

Find the `#PubkeyAuthentication yes` line and remove the `#` in front to uncomment the line.

Then find the `#AuthorizedKeysFile .ssh/authorized_keys .ssh/authorized_keys2` line and remove the `#` to uncomment the line.

Additionally for better security you can do the following:

- Set `PermitRootLogin` to `yes`
- Change the `Port` to some number of your choice (22-65000) (Make sure it's at least 2 digits and avoid common ports used by other apps like: 21, 80, 35, 8080, 3000, etc...)
- Uncomment `#PasswordAuthentication yes` by removing the `#` in front and set it to `yes` (This will disable password login, you will be able to login with SSH keys only!)

Save the file with `CTRL + O`, hit Enter, close it with `CTRL + X`.

Now we need to restart the SSHD service with:

```bash
sudo systemctl restart sshd
```

Let's check if everything is working correctly:

```bash
sudo systemctl status sshd
```

If everything has been configured as it should be you should see `active (running)` as a status of the service.

If not, open the config file again and check for mistakes.

Press `q` to exit the log mode.

Logout from the `mcc` user with `exit` command, and then logout from the root `ubuntu` user by typing `exit` again.

Now we can login to the user with our private `MCC_Key` file.

Command:

```bash
ssh -i <path to the MCC_Key private key> mcc@<ip here>
```

Example:

```bash
ssh -i MCC_Key mcc@3.71.108.69
```

<div class="custom-container note"><p class="custom-container-title">Note</p>

**If you've changed the `Port`, make sure you add a `-p <your port here>` option after the `-i <key>` option (eg. `ssh -i MCC_Key -p 8973 mcc@3.71.108.69`)!**

</div>

If did everything correctly you should see a Linux prompt and a welcome message if there is one on your provider.

You can do `whoami` to see your username.

Now you can install the .NET 10 SDK and MCC.

</details>

### Installing .NET 10 SDK

<details>
<summary>.NET SDK installation on VPS</summary>

<div class="custom-container note"><p class="custom-container-title">Note</p>

**If your VPS has an ARM CPU, follow [this](#installing-net-on-arm) part of the documentation and then return to section after this one.**

</div>

Log in as the user you've created.

Update the system packages and package manager repositories:

```bash
sudo apt update -y && sudo apt upgrade -y
```

On Ubuntu 24.04 LTS, the official Microsoft docs say .NET is available directly from the Ubuntu package feeds, so you do not need to add the old Microsoft package repository for .NET 10. Install the SDK with:

```bash
sudo apt-get update -y && sudo apt-get install -y dotnet-sdk-10.0
```

You can verify the installation with:

```bash
dotnet --info
```

Run the following command to check if everything was installed correctly:

```bash
dotnet
```

You should get:

```
Usage: dotnet [options]
Usage: dotnet [path-to-application]

Options:
  -h|--help         Display help.
  --info            Display .NET information.
  --list-sdks       Display the installed SDKs.
  --list-runtimes   Display the installed runtimes.

path-to-application:
  The path to an application .dll file to execute.
```

If you do not get this output and the installation was not successful, [try other methods](https://learn.microsoft.com/en-us/dotnet/core/install/linux-ubuntu-install).

If it was successful, you can now install MCC.

</details>

### Installing MCC on a VPS

<details>
<summary>MCC installation and screen usage</summary>

Now that you have the .NET SDK and a user account, install the `screen` utility. You will need it if you want MCC to keep running after you close the SSH session.

<div class="custom-container note"><p class="custom-container-title">Note</p>

**There is also a Docker method, if you're using Docker, you do not need the `screen` program.**

</div>

You can also learn about the `screen` command from [this YouTube tutorial](https://youtu.be/_ZJiEX4rmN4).

To install the `screen` execute the following command:

```bash
sudo apt install screen -y
```

Now you can install the MCC:

- [Download a compiled binary](#download-a-compiled-binary)
- [Building from the source code](#building-from-the-source-code)
- [Run using Docker](#using-docker) (Doesn't require the `screen` command)

How to use the `screen` command?

<div class="custom-container warning"><p class="custom-container-title">Warning</p>

**If you have issues with Screen command, like output not being properly formatted or program handing/freezing, try using tmux, click [here](https://www.youtube.com/watch?v=Yl7NFenTgIo) to learn how to use it.**

</div>

To start a screen, type:

```bash
screen -S mcc
```

<div class="custom-container note"><p class="custom-container-title">Note</p>

**`mcc` here is the name of the screen, you can use whatever you like, but if you've used a different name, make sure you use that one instead of the `mcc` in the following commands.**

</div>

<div class="custom-container note"><p class="custom-container-title">Note</p>

**You need to make a screen only once, however if you reboot your VPS, you need to start it on each reboot.**

</div>

Now you will be in the screen, now you can start the MCC and detach from the screen.

To detach from the screen press `CTRL + A + D`.

To re-attach/return to the screen, execute the following command:

```bash
screen -r mcc
```

If you've accidentally closed the SSH session without detaching from the screen it might be still attached, to detach it use:

```bash
screen -d mcc
```

To list out screens you can use:

```bash
screen -ls
```

To stop the MCC, you can hit `CTRL + D` (hit it few times).

</details>