YouTrack for YunoHost

Community YunoHost package for the official JetBrains YouTrack Server Docker image.

Status

This package is ready for review and testing, but it has not yet been tested on a real disposable YunoHost VM. Do not deploy it directly on a production server without completing the test matrix below.

Included integration

• YunoHost packaging format v2
• Dedicated-domain installation
• Official pinned YouTrack container image
• NGINX reverse proxy with WebSocket and live-update support
• systemd lifecycle management
• Persistent data, conf, logs and backups volumes
• Consistent YunoHost backup and restore
• Upgrade and domain-change scripts
• German and English administrator documentation

Requirements

• YunoHost 12.1.38 or newer
• AMD64 server
• At least 2 GB RAM recommended
• At least 5 GB free disk space for installation; production data needs additional space
• A dedicated domain with working HTTPS

Install from a local checkout

sudo yunohost app install /path/to/youtrack_ynh --debug

Publish on Forgejo

git init
git add .
git commit -m "Initial YouTrack YunoHost package"
git branch -M main
git remote add origin https://forgejo.example.org/USER/youtrack_ynh.git
git push -u origin main

Install using the Forgejo branch archive URL:

sudo yunohost app install \
  https://forgejo.example.org/USER/youtrack_ynh/archive/main.tar.gz \
  --debug

Required test matrix

Run all tests on a disposable YunoHost VM before production use:

1. Fresh installation and configuration wizard
2. Login, issue creation, attachment upload and Whiteboard WebSocket connection
3. YunoHost backup followed by restore
4. Package upgrade from the same version
5. Domain change
6. Uninstall and reinstall
7. Reboot and automatic service startup
8. Forgejo/Gitea VCS token, commit and pull-request integration

License

The packaging code in this repository is licensed under the MIT License. YouTrack itself is proprietary software and remains subject to the JetBrains license agreement.