Installing the MCSH-CLI
Already have scoop.sh? Run
scoop install mcsh after adding our bucket listed below.
How to setup the MCSH CLI on Windows
The MCSH command-line interface will give you console access, the ability to set up and modify your servers, create snapshots, and much more! This article will go over setting up your server.
Before we continue, please ensure you register here at our authentication server. Make sure to use the same email you purchased your namespace with!
scoop is a package manager. A package manager is something that downloads and installs programs for you! Typically, you would download an executable file and go through some windows to install some applications. Using Scoop, we can simplify the process for developers on our end and you the user by running just one command to install it all!
First, open up, PowerShell.
We will run
Set-ExecutionPolicy RemoteSigned -scope CurrentUser and then type in
enter to allow us to run this script to install scoop.sh.
Set-ExecutionPolicy RemoteSigned -scope CurrentUserto allow permission for the script
iwr -useb get.scoop.sh | iexto install scoop. more information on scoop
Scoop contains programs in what is known as “buckets”. Buckets are a list of programs and their installation instructions. For the MCSH CLI, we will need a bucket called “extras” and our bucket named “MCSH”.
scoop bucket add extrasto add the extra directory listing
scoop bucket add mcsh https://github.com/mcserverhosting-net/scoop.gitto add our directory listing and keep in sync with updates.
Now that we have everything we need, we are ready to install the mcsh CLI! It will install with one command!
scoop install git
scoop install mcsh
You’ve successfully installed the mcsh CLI! From here, you will have access to the NA and EU cluster. Let’s do some post configuration.
We have two clusters. We want to make sure we are talking to the cluster your server is on.
mcsh config use-context mcsh-naif you have a NA server
mcsh config use-context mcsh-euif you have an EU server
After this, we will tell the CLI to use your namespace. Our customers each have one namespace that keeps them isolated among the others. You can only see and control your servers on our clusters.
Don’t forget to replace your-namespace-here with your actual namespace! Your namespace is in your email. If you don’t know this, install
mcsh config set-context --current --namespace=your-namespace-here
Test things out!
Let’s run a quick demo command! Once you try to get or edit resources in our cluster, a browser will go to our portal to log you in. Afterward, it will keep a token that will be valid for a set timeframe for you to execute any other commands.
mcsh get minecraftservers.
No resources found in your namespace.
If it looked like this, don’t worry. It worked! We need to create your first Minecraft server with us!
You’re all set up! Please proceed to our next section on Creating a Minecraft Server!