oss/luanti
oss/luanti
1
0
Fork 0
mirror of https://github.com/luanti-org/luanti.git synced 2025-07-22 17:18:39 +00:00
Code Wiki Activity

Remove empty sections

Browse source
This commit is contained in:
tim-win 2025-04-20 21:57:48 -04:00
parent d7bf6b849c
commit e6beea2ffa
1 changed files with 3 additions and 34 deletions
Download patch file Download diff file Expand all files Collapse all files

37
doc/docker_server.md
View file

@ -83,41 +83,22 @@ services:
⚠️ **CRITICAL**: The server requires a valid configuration file to run properly. ⚠️ **CRITICAL**: The server requires a valid configuration file to run properly.
Download the example configuration file and customize it: Download the example configuration file and optionally customize it:
```shell ```shell
# Download the example config file # Download the example config file
wget https://raw.githubusercontent.com/luanti-org/luanti/master/minetest.conf.example -O ~/luanti/conf/minetest.conf wget https://raw.githubusercontent.com/luanti-org/luanti/master/minetest.conf.example -O ~/luanti/conf/minetest.conf
# Edit the file to add your settings
nano ~/luanti/conf/minetest.conf
``` ```
At minimum, add or update these settings: If no config file is present, the server will crash on startup.
```
# Set admin username (required to grant privileges)
name = YourAdminUsername
# Server settings
server_name = My Luanti Server
server_description = My awesome server
port = 30000
```
Without a proper configuration file, the server will crash on startup.
## Permissions and Technical Details ## Permissions and Technical Details
- The container runs as user `minetest` with UID 30000 - The container runs as user `minetest` with UID 30000
- Fix permission issues with: `sudo chown -R 30000:30000 ~/luanti/{data,conf}` - Fix permission issues with: `sudo chown -R 30000:30000 ~/luanti/{data,conf,games}`
- Entrypoint is `/usr/local/bin/luantiserver` - Entrypoint is `/usr/local/bin/luantiserver`
- Default command arguments: `--config /etc/minetest/minetest.conf` - Default command arguments: `--config /etc/minetest/minetest.conf`
## Troubleshooting
### Common Errors
#### "Game not found" Error #### "Game not found" Error
If you get an error like `ERROR[Main]: Game "mineclone2" not found`, check: If you get an error like `ERROR[Main]: Game "mineclone2" not found`, check:
@ -134,16 +115,4 @@ If the server crashes immediately, it's often due to a missing or invalid config
2. You've mounted it correctly to `/etc/minetest/minetest.conf` 2. You've mounted it correctly to `/etc/minetest/minetest.conf`
3. The file has appropriate permissions 3. The file has appropriate permissions
### Listing Available Games
To check which games are available to the server:
```shell
docker run --rm \
--entrypoint /bin/sh \
-v ~/luanti/games/mineclone2:/usr/local/share/luanti/games/mineclone2 \
ghcr.io/luanti-org/luanti:master \
-c "/usr/local/bin/luantiserver --gameid list"
```
**Note:** If you don't understand the previous commands please read the [official Docker documentation](https://docs.docker.com) before use. **Note:** If you don't understand the previous commands please read the [official Docker documentation](https://docs.docker.com) before use.