Home Documentation Tracker Download


Free Software

subshare is Free Software released under the AGPL. Its source codes are hosted here on GitHub.

Please feel free to check out the source codes and study them. It's a very good idea, anyway, to download the sources and build the binaries yourself. This is probably the most secure way of using this software, making it extremely difficult for an attacker to provide malicious code to you.

Furthermore, you are - of course - very welcome to contribute. Please contact us, if you want to lend us a hand.

Contributor licence agreement

By contributing to this project, you accept the conditions of the AGPL and also grant the CodeWizards GmbH an irrevocable and non-exclusive permission to work with your contributions. This includes the right to licence your contributions to third parties under another licence, at the sole discretion of the CodeWizards. You do not give up any right to use your contributions yourself, but you do give up the right to constrain what the CodeWizards are allowed to do with your contributions.

Setting up a workspace

Step 1: Eclipse

Download and start Eclipse. The "Eclipse IDE for Java Developers" is recommended.

Step 2: Git

Open the "Git Repository Exploring" perspective. If you do not have it, you're likely still missing EGit.

Then clone this Git repository: https://github.com/subshare/subshare.git

Step 3: Import projects

Open the "Java" perspective and click in the main menu on "File" => "Import…". Select "Gradle" / "Gradle Project". Select the root project in your Git working copy and import all projects (the root project "org.subshare" and all its children).

If you do not find "Gradle" in Eclipse’ import wizard, you likely still need to install Buildship.

Step 4: DataNucleus Eclipse Plug-in

Install the DataNucleus Eclipse Plug-in, open the "Java" perspective, right-click the project "org.subshare.local" in the "Package Explorer" view.

Then select "DataNucleus" => "Add DataNucleus Support". Finally, repeat the double-click on the same project and check "DataNucleus" => "Enable Auto-Enhancement".

Repeat this for the project "org.subshare.local.dbrepo". Both projects require DataNucleus’ enhancement.