diff --git a/home/server-installation.html b/home/server-installation.html index 1d3e799..3c75f05 100644 --- a/home/server-installation.html +++ b/home/server-installation.html @@ -51,8 +51,9 @@ dateCreated: 2020-06-17T21:05:01.162Z

For the Linux installation, see the next step.

Please ensure you have port-forwarded before attempting to host a server! Without you ports being forwarded, you cannot host a server to the public!

    -
  1. Download the server zip from beammp.com. You should end up with a compressed .zip archive, called something like BeamMP-Server.zip.
    2. -
  2. Extract the BeamMP-Server.zip. You will end up with a BeamMP-Server.exe file, among others which you can ignore for now. Make a folder somewhere and put the BeamMP-Server.exe there. This is where your server will live.
    3. +
  3. Ensure you have installed the Visual C++ Redistributables in order to run the server.
    4. +
  4. Download the server executable from beammp.com. You should end up with an executable file, called something like BeamMP-Server.exe.
    5. +
  5. Once downloaded, make a folder somewhere and put the BeamMP-Server.exe there. This is where your server will live.
  6. Start the server once by double-clicking on it. This will generate all the necessary files for you, once you see text you can close it and proceed to the next step. You should see a Server.log file and a ServerConfig.toml file next to your BeamMP-Server.exe.
  7. (optional) For quick access in the future you can easily create a desktop shortcut to BeamMP-Server.exe using [Right click] > Send to > Desktop (create shortcut).
@@ -61,19 +62,20 @@ dateCreated: 2020-06-17T21:05:01.162Z

3.b. Installation on Linux

Skip this if you did “Installation on Windows”.

Using our build (recommended)

-

This step will work on Debian, Ubuntu, and similar Debian-derivatives on x86_64. If you're on a different distribution or architecture, refer to the "Building from source” step below.

+

This step will work on all distributions we provide binaries for here. If you're on a different distribution or architecture, refer to the "Building from source” step below.

    -
  1. Ensure you have the dependencies installed which are listed here.
    2. -
  2. Download the server zip from beammp.com. You should end up with a compressed .zip archive, called something like BeamMP-Server.zip.
    3. -
  3. Extract the BeamMP-Server.zip. You will end up with a BeamMP-Server-linux file, among others which you can ignore for now. Make a folder somewhere and put the BeamMP-Server-linux there. This is where your server will live.
    4. -
  4. Open a terminal, go to that folder you put the BeamMP-Server-linux in, and run chmod +x BeamMP-Server-linux. This ensures that you have permissions to run it.
    5. -
  5. Start the server once by running it with ./BeamMP-Server-linux. This will generate all the necessary files for you, once you see text you can close it and proceed to the next step. You should see a Server.log file and a ServerConfig.toml file next to your BeamMP-Server-linux.
    6. +
  6. Ensure you have the dependencies installed which are listed here.
    7. +
  7. Go to BeamMP.com and click the “Download Server” button, you will be redirected to the server's Github release page.
    8. +
  8. Download the correct version for your distro. For sake of semplicity it will be called BeamMP-Server-xxx from now on, where xxx denotes the version for the distro you're using.
    9. +
  9. Once downloaded, you should see one file called BeamMP-Server-xxx, among others which you can ignore for now. Make a folder somewhere and put the BeamMP-Server-xxx there. This is where your server will live.
    10. +
  10. Open a terminal, go to that folder you put the BeamMP-Server-xxx in, and run chmod +x BeamMP-Server-xxx. This ensures that you have permissions to run it.
    11. +
  11. Start the server once by running it with ./BeamMP-Server-xxx. This will generate all the necessary files for you, once you see text you can close it and proceed to the next step. You should see a Server.log file and a ServerConfig.toml file next to your BeamMP-Server-xxx.
  12. (optional) It is heavily recommended to set up a user called beammpserver (or similar), as we do NOT recommend running the server as root, sudo or with your personal user account. You should then take steps to make sure that you start the server as this user only.

Now proceed to the next step.

 

Building from source

-

BeamMP-Server for Linux can be officially built on both Debian, Ubuntu, other Debian-derivatives, and ArchLinux. Other distributions are likely to work, too, but aren't officially supported. If you want to build it yourself you can do it by downloading the source on our GitHub, a tutorial can be found here.

+

Other distributions in addition to the ones that already have a binary here are likely to work too, but aren't officially supported. If you want to build it yourself you can do it by downloading the source on our GitHub, a tutorial can be found here.

At the end, make sure to run your server once with ./BeamMP-Server and then proceed to the next step.

 

4. Configuration

diff --git a/home/server-maintenance.html b/home/server-maintenance.html index 09abdd2..81d0eb3 100644 --- a/home/server-maintenance.html +++ b/home/server-maintenance.html @@ -219,20 +219,21 @@ dateCreated: 2021-06-20T08:48:03.720Z

If you built from source, you just rebuild. Make sure to run git submodule update --init --recursive before you rebuild.

On Windows

    +
  1. Ensure you have installed the Visual C++ Redistributables in order to run the server.
  2. Go to BeamMP.com and click the “Download Server” button.
    3. -
  3. Once downloaded, extract the zip file. You should see a few files, one of them the BeamMP-Server.exe. We will call this one the “new executable”.
    4. +
  4. Once downloaded, you should see one file called BeamMP-Server.exe. We will call this one the “new executable”.
  5. Go to the folder where your current BeamMP-Server.exe executable is located (same folder where your ServerConfig.toml is, usually). We will call this one the “old executable”.
  6. Replace the old executable with the new executable (for example by copying or moving the new executable into the folder).

On Linux

    -
  1. Go to BeamMP.com and click the “Download Server” button.
    2. -
  2. Once downloaded, extract the zip file. You should see a few files, one of them the BeamMP-Server-linux. We will call this one the “new executable”.
    3. -
  3. Go to the folder where your current BeamMP-Server-linux executable is located (same folder where your ServerConfig.toml is, usually). We will call this one the “old executable”.
    4. +
  4. Go to BeamMP.com and click the “Download Server” button, you will be redirected to the server's Github release page.
    5. +
  5. Download the correct version for your distro. For sake of semplicity it will be called BeamMP-Server-xxx from now on, where xxx denotes the version for the distro you're using.
    6. +
  6. Once downloaded, you should see one file called BeamMP-Server-xxx depending on the version you've downloaded. We will call this one the “new executable”.
    7. +
  7. Go to the folder where your current BeamMP-Server-xxx executable is located (same folder where your ServerConfig.toml is, usually). We will call this one the “old executable”.
  8. Replace the old executable with the new executable (for example by copying or moving the new executable into the folder).
    9. -
  9. Open a terminal in that folder where you just replaced the executable, and run sudo chmod +x BeamMP-Server-linux. This will make sure the server can be run.
    10. +
  10. Open a terminal in that folder where you just replaced the executable, and run sudo chmod +x BeamMP-Server-xxx. This will make sure the server can be run.

Automated Updates

The server does not support automatic updates or update notifications (yet).

-

You can, however, ask the GitHub API for the lastest release by checking the server's version against the tags. You can get that by GET'ing from https://api.github.com/repos/BeamMP/BeamMP-Server/git/refs/tags.

-

 

+

You can, however, ask the GitHub API for the lastest release by checking the server's version against the tags. You can get that by GET'ing from https://api.github.com/repos/BeamMP/BeamMP-Server/git/refs/tags.

\ No newline at end of file