7.4, 8.0 or 8.1 (recommended) with the following extensions:
5.7.22 or higher (MySQL 8 recommended) or MariaDB 10.2 or higherHere we will be covering installing NamelessMC on Ubuntu or Debian. We recommend using the latest version (Ubuntu 22.04 or Debian 11 bullseye) so you don't need third party repositories to get the latest software.
The commands below are simply an example of how you might install these dependencies. Please consult with your operating system's package manager to determine the correct packages to install.
Depending on your chosen distribution and distribution version (assuming recent enough) this will install PHP 7.4, 8.0 or 8.1 which are all supported. We recommend using your distribution's central repository. However, if you want to use the latest PHP version instead of the version provided by your distribution, add a third party repository like https://deb.sury.org/
# Choose one of the options below, do not run them all
# Option 1: Nginx + php-fpm
apt install nginx php-fpm
# Option 2: Apache + php-fpm
apt install apache2 php-fpm
# Option 3: Apache + mod_php
apt install php
# Install required extensions
apt install php-{curl,exif,gd,mbstring,mysql,pdo,xml}
# Install MariaDB database server
apt install mariadb-server
The first step in this process is to create the folder where the website will live.
mkdir -p /var/www/html
Once you have created a new directory for the website, you can download and extract NamelessMC into it. You can do this manually, or use the example command provided below to do it automatically.
# Depending on whether you have curl or wget, choose one of the two commands below. The commands do the exact same thing.
curl -L "https://github.com/NamelessMC/Nameless/releases/latest/download/nameless-deps-dist.tar.xz" | tar --xz --extract --directory=/var/www/html --file -
wget -O - "https://github.com/NamelessMC/Nameless/releases/latest/download/nameless-deps-dist.tar.xz" | tar --xz --extract --directory=/var/www/html --file -
Ensure files are owned by the correct user, with correct permissions:
chown -R www-data:www-data /var/www/html
chmod -R ugo-x,u+rwX,go-rw /var/www/html
Now that all of the files have been downloaded we need to configure the database.
You will need a database setup and a user with the correct permissions created for that database before continuing any further. See below to create a user and database for your website quickly. To find more detailed information please have a look at Setting up MySQL.
mysql -u root -p # Remember to change 'yourPassword' below to be a unique > password CREATE USER 'nameless'@'127.0.0.1' IDENTIFIED BY 'yourPassword'; CREATE DATABASE nameless; GRANT ALL PRIVILEGES ON nameless.* TO 'nameless'@'127.0.0.1' WITH GRANT OPTION; exit
You have successfully installed NamelessMC. Now all that's left to do is setup your webserver configuration