Launch digiRunner locally.

[vulcanshen-tpi]

Task-Compose is a convenient command-line utility.

I successfully used Task-Compose to set up and launch digiRunner locally.

Here is my implementation

[TPIsoftwareOSPO]

Hi vulcanshen-tpi,

Thank you so much for sharing this excellent guide! This is a fantastic and very practical solution for H2 database persistence that will surely help many users. The step-by-step instructions are incredibly clear.

We are curious to learn more about your experience. Could you share what motivated you to create this guide? For example, were you setting up DigiRunner for a specific project or proof-of-concept that required the data to be saved permanently?

Any insight you can share about your use case would be incredibly valuable to the community and to us.

Thanks again for this great contribution!

[vulcanshen-tpi]

Hi, I am the creator of task-compose! My main goal in developing task-compose was to provide a more streamlined and convenient way to launch the digiRunner open-source project. With it, users no longer need to manually clone or compile anything.

What's more, it can automatically detect if an H2 database already exists and adjust the launch parameters accordingly. This not only offers a complete startup solution but also serves as a practical use case for task-compose itself. For the digiRunner open-source project, it means an additional quick-start option, which I believe makes this a true win-win approach.

[TPIsoftwareOSPO]

Hi vulcanshen-tpi,

Thank you for sharing more about your motivation and the background of Task-Compose — it's great to hear that you're the creator!

We truly appreciate how Task-Compose enhances the digiRunner onboarding experience by removing the need for manual cloning or compilation. The smart detection of the H2 database and dynamic launch configuration is a brilliant feature, and we agree — this definitely adds a meaningful quick-start option for new users.

Would you be open to us referencing Task-Compose as an alternative installation method in our documentation center or GitHub README? We believe many users would benefit from it, and we’d love to help spread the word.

Thanks again for your contribution — looking forward to collaborating further!

Best regards,
Eddie
Open Source Program Office (OSPO)

[vulcanshen-tpi]

I've created manual GitHub Actions to automate the packaging process for task-compose and digirunner-opensource releases. Additionally, I designed the content of task-compose.yaml for the official release of this project.

You can now download portable packages for both ARM Mac and AMD64 Windows.

After downloading, simply run the task-compose-portable (or task-compose-portable.exe on Windows) executable from the unzipped directory. You will be prompted to grant Java execution permissions; please allow it. Once the service starts, you can open your browser and navigate to http://localhost:31080/dgrv4/login to log in.

Please refer to the following link for the releases:
https://github.com/vulcanshen-tpi/how-to-make-digirunner-opensource-launch-standalone/releases