Installation and configuration

Basic Installation

First, download the latest version of the ShittyAuthServer from here

Then, run it using

$ java -jar ShittyAuthServer-VERSION.jar

Once the server has started, navigate to http://yourserverip:8880/ in your browser. You should be prompted with the WebinterfaceAPI setup page. During the setup, you can configure things like HTTPS, allowed authentication methods etc.

It is recommended to only enable password authentication, as that is what is used for ShittyAuth Minecraft accounts.

Once you're done with the setup, log in using your admin account. Any further configuration will be made using this account.

Configuring the server

Custom Domain

If you want to use a custom domain for your server (e.g. mc.example.com), you need to change some settings.

• Firstly, you need to configure the WebinterfaceAPI to use your custom domain (if you haven't already done that during the setup).

  To do that, navigate to the WebinterfaceAPI > Settings tab and change the HTTP Host setting to your desired domain.

• You should also change it for the ShittyAuthServer, so skins will be served from the correct domain.

  Navigate to the Minecraft > Settings tab and change the Skin base URL to http://mc.example.com (don't accidentally add a trailing slash and make sure to replace the domain with your desired domain).

Enabling HTTPS

To enable HTTPS support, you need to already have a custom domain and a valid certificate for that domain.

• Navigate to the WebinterfaceAPI > Settings tab and check the Enable HTTPS checkbox. Make sure your domain is set as the HTTPS Host
• Enter the path to your certificate in the HTTPS Certificate path field. The path should be an absolute path to the file, but you can also configure a path relative to the JAR file's working directory
• Do the same for your certificate's private key
• If your certificate is protected using a password, enter the password in the HTTPS Certificate password field.

Configuring a proxy server (Apache)

TODO