AppleTunneler/README.md

39 lines
1.7 KiB
Markdown

# Warning
before using the plugin those steps were made on a linux machine not sure about windows
but those might work on any unix system like bsd or freebsd
# How to setup on |*ssh server in linux*|
* create user in your system using the command provided below
``useradd xrambad --shell=/bin/true``
this will make the user have no shell + sftp and scp access.
* create ssh key for the user.
* there will be issue that user can't login to fix this
add ``/bin/true`` to ``/etc/shells``
* start your minecraft server with the plugin installed.
but you will notice that it will not load the plugins as shown down below.
```
[09:16:17 WARN]: [AppleTunneler] no Identities files found, please put them in plugins/AppleTunneler/Identities
[09:16:17 ERROR]: Error occurred while enabling AppleTunneler v1.0-SNAPSHOT (Is it up to date?)
```
* place your user that you created private key into ``plugins/AppleTunneler/Identities`` folder
* start server again, but you will be met with another error as shown below
```
[09:20:16 ERROR]: [AppleTunneler] FILE at path: /home/test/Desktop/test-server/plugins/AppleTunneler/.known_hosts Does not exists
[09:20:16 ERROR]: Error occurred while enabling AppleTunneler v1.0-SNAPSHOT (Is it up to date?)
java.lang.RuntimeException: Known host file does not exists in plugin folder
```
as you can see the error created path for us which will be easy for us to create the file, now copy the path.
* run this command to create the host file
``ssh-keyscan limework.net >> /home/test/Desktop/test-server/plugins/AppleTunneler/.known_hosts``
* now modify the config of the plugins for your needs by setting host, port, username of ssh server and setting tunneling needed.
and done.