doc: Support use of Apache (#40)

minetest · Dec 28, 2020 · 578a7bc · 578a7bc
1 parent e99ecd6
commit 578a7bc
Showing 1 changed file with 32 additions and 2 deletions.
diff --git a/README.md b/README.md
@@ -57,7 +57,7 @@ Setting up the server
 ---------------------
 
   1. Install Python 3 and pip:
-  
+
 	pacman -S python python-pip
 	# OR:
 	apt-get install python3 python3-pip
@@ -96,10 +96,40 @@ Setting up the server
 		uwsgi_pass ...;
 	}
 
+Setting up the server (Apache version)
+---------------------
+
+If you wish to use Apache to host the master server, do steps 1-2, 4, above. Additionally install/enable mod_wsgi and an Apache site config like the following:
+
+		# This config assumes you have the master-server at DocumentRoot.
+		# Visitors to the server list in this config would visit http://local.server/ and
+		# apache would serve up the output from server.py. Static resources would be served
+		# from http://local.server/static.
+
+		# Where are the minetest-server files located?
+		DocumentRoot /var/games/minetest/master-server
+
+		# Serve up server.py at the root of the URL.
+		WSGIScriptAlias / /var/games/minetest/master-server/server.py
+
+		# The name of the function that we call when we invoke server.py
+		WSGICallableObject app
+
+		# These options are necessary to enable Daemon mode. Without this, you'll have strange behavior
+		# with servers dropping off your list! You can tweak threads as needed. See mod_wsgi documentation.
+		WSGIProcessGroup minetest-master-server
+		WSGIDaemonProcess minetest-master-server threads=2
+
+
+		<Directory /var/games/minetest/master-server>
+			Require all granted
+		</Directory>
+
+	</VirtualHost>
+
 License
 -------
 
 The Minetest master server is licensed under the GNU Lesser General Public
 License version 2.1 or later (LGPLv2.1+).  A LICENSE.txt file should have been
 supplied with your copy of this software containing a copy of the license.
-