new/README.md

73 lines
1.7 KiB
Markdown

# NEW MC Server - Powered by Garde Studios
## Development
### (Prerequisite) Install Docker
Go to the Website [docker.com](https://www.docker.com/) and download the Docker Desktop Version for you're Operating System.
In case you're using Linux find a guide on the internet. For RHEL/Fedora/CentOS/Rocky Linux the setup process is as follows:
```bash
sudo dnf check-update # Update System
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo # Add the docker repo to dnf
sudo dnf install docker-ce docker-ce-cli containerd.io -y # Install docker engine
sudo systemctl start docker # start docker deamon
sudo systemctl enable docker # enable docker deamon on startup
sudo usermod -aG docker $(whoami) # elevate user to use docker cmd
```
### Starting the Server
> [!WARNING]
> Make sure you first configure the `docker-compose.yml` under the `environment` section to use the appropiate ammount of RAM youre system can provide.
> 16GB isn't sensible in most development/testing environments
Start a Terminal or use Docker Desktop
> [!NOTE]
> The first Startup creates the whole infrastructure behind the project and can take up some time.
> Make sure you grab some 0xCOFFE :)
#### Using Docker CLI
cd into the repo.
Start the Server:
```bash
docker compose up
```
To close it just use `ctrl+c`.
Deamon Mode:
```bash
docker compose up -d
```
To hook into the servers logs use:
```bash
docker logs <container-name>
```
Killing the server is done in two ways.
Either by killing it directly:
```bash
docker kill <container-name>
```
Or by hooking against the compose file:
```bash
docker compose down
```
## Architecture
![](assets/Architecture-Overview.png)