Skin Server

This is a simple skin server to downloading, pre-caching and rendering

Features:

• Render a skin head based on a file
• Render a skin/head based on uuid or username
• Save skins into database for long-time cache
• Token based IP Selection for mojang requests
• Dockerized
• Kubernetes ready

Installation with Docker

Run this command to start a single instance with mongodb properties.

docker run --name skinserver \
  -d \
  -e SPRING_DATA_MONGODB_AUTHENTICATION-DATABASE=admin \
  -e SPRING_DATA_MONGODB_DATABASE=skinserver \
  -e SPRING_DATA_MONGODB_HOST=127.0.0.1 \
  -e SPRING_DATA_MONGODB_PORT=27017 \
  -e SPRING_DATA_MONGODB_PASSWORD=YourPassword \
  -e SPRING_DATA_MONGODB_USERNAME=YourUsername \
  -e SKINSERVER_MAX-SIZE=512 \
  -e SKINSERVER_MIN-SIZE=16 \
  -e SKINSERVER_CONNECTION-ADDRESSES_0=127.0.0.1 \
  -p 8080:8080 \
   ghcr.io/themeinerlp/skinserver/skinserver:latest

Modify your database, host, username and password for the mongodb server. Optional: Modify SKINSERVER_MIN/MAX-SIZE and extend your IP Address Range

Installation with Docker-Compose

Copy the content below and paste it into a docker-compose.yaml file

version: '3.1'
services:
  mongo:
    image: mongo
    restart: always
    environment:
      MONGO_INITDB_ROOT_USERNAME: YourUsername
      MONGO_INITDB_ROOT_PASSWORD: YourPassword
      MONGO_INITDB_DATABASE: SkinServer
  skin-server:
    image: ghcr.io/themeinerlp/skinserver/skinserver
    restart: always
    ports:
      - 8080:8080
    environment:
      SPRING_DATA_MONGODB_AUTHENTICATION-DATABASE: admin
      SPRING_DATA_MONGODB_DATABASE: SkinServer
      SPRING_DATA_MONGODB_HOST: mongo
      SPRING_DATA_MONGODB_PORT: 27017
      SPRING_DATA_MONGODB_USERNAME: YourUsername
      SPRING_DATA_MONGODB_PASSWORD: YourPassword
      SKINSERVER_MAX-SIZE: 512
      SKINSERVER_MIN-SIZE: 16
      SKINSERVER_CONNECTION-ADDRESSES_0: 127.0.0.1

Then run following commands:

docker-compose up -d