About

🐳 JetBrains License Server Docker image based on Alpine Linux.
If you are interested, check out my other 🐳 Docker images!

Features

Included

• Nginx reverse proxy
• License server completely customizable via environment variables
• Registration data and configuration in a single directory

From docker-compose

• Reverse proxy with nginx-proxy
• Creation/renewal of Let's Encrypt certificates automatically with letsencrypt-nginx-proxy-companion

Docker

Environment variables

• TZ : The timezone assigned to the container (default to UTC)
• JLS_VIRTUAL_HOSTS : Virtual hosts where license server will be available (required ; comma delimited for several hosts)
• JLS_ACCESS_CONFIG : JSON file to configure user restrictions (default to /data/access-config.json)
• JLS_STATS_RECIPIENTS : Reports recipients email addresses for stats (comma delimited)
• JLS_SMTP_SERVER : SMTP server host to use for sending stats (stats disabled if empty)
• JLS_SMTP_PORT : SMTP server port (default to 25)
• JLS_SMTP_USERNAME : SMTP username (auth disabled if empty)
• JLS_SMTP_PASSWORD : SMTP password (auth disabled if empty)
• JLS_STATS_FROM : From address for stats emails
• JLS_STATS_TOKEN : Enables an auth token for the stats API at /reportApi (HTTP POST)

Volumes

• /data : Contains registration data and configuration

Ports

• 80 : HTTP port

Usage

Docker compose is the recommended way to run this image. You can use the following docker compose template, then run the container :

docker-compose up -d
docker-compose logs -f

Or use the following minimal command :

$ docker run -d -p 8000:80 --name jetbrains-license-server \
  -e TZ="Europe/Paris" \
  -e JLS_VIRTUAL_HOSTS=jetbrains-license-server.example.com \
  -v $(pwd)/data:/data \
  crazymax/jetbrains-license-server:latest

Update

Recreate the container whenever i push an update :

docker-compose pull
docker-compose up -d

Troubleshooting

If you have any trouble using the license server, check the official Troubleshooting page of Jetbrains.

Error 403 Passed value of header "Host" is not allowed

If you've got the following message :

Passed value of header "Host" is not allowed. Please contact your license server administrator.

That's because the license server is running behind the Nginx reverse proxy. Please configure virtual hosts using the JLS_VIRTUAL_HOSTS variable.

How can i help ?

We welcome all kinds of contributions 🙌!
The most basic way to show your support is to star 🌟 the project, or to raise issues 💬
Any funds donated will be used to help further development on this project! 💝

License

MIT. See LICENSE for more details.