Welcome to the Worldwide list of Java User Groups (JUGs) !

This website it is based in 100% opensource technologies, and it is dynamically rendered based on the data located in the different folders saved in this repository.

We strongly invite you to improve this website by submitting a PR to include any of the JUGs we have available around the world or by providing new functionalities for the end users of this website.

This website is based on Jekyll. To run it you need to set up a Ruby (minimum 2.4.1) environment.

To set up a Ruby environment we recommend:

• rbenv (Linux and MacOS)
• RubyInstaller or Chocolatey (Windows)

After you have Ruby installed, install all the required dependencies running:

bundle install

Once you have the project with all the dependencies installed, you can launch it in local with the following command:

bundle exec jekyll serve

This will start a jekyll server on http://127.0.0.1:4000 Once it is loaded, you can open it with your favourite browser.

• http://localhost:4000/GlobalWWJugs/index.html

The content you can see, it will be updated every time you made changes in your local files.

Alternatively you can run the site locally via Docker. This has the benefit of not requiring you to install and manage Ruby versions directly on your machine.

Assuming you have already installed Docker and docker-compose (e.g. via Docker Desktop for Mac and Windows) you can build and run the site locally with:

docker-compose up

Visit the main page

For adding a new JUG you only need to submit a PR that should include a new .md file saved in the _jugs folder that should contain all the mandatory information (name, website and location for locating in the map). Check the the main page to see some properties.

For locating your JUG properly in the map, it is recommended opening the map with your browser, go to its console and click in the place you desire. You should see the coordinates you can use for storing it in your .md file. Alternatively you can use latlong.net or any other latitude and longitude finder.

Feel free to reach out using one of the following channels:

• Official mailing list ( jug-leaders@jugs.groups.io )
• Slack

• Q&A
• Newsletter
• Track speakers
• Code of conduct