depot/nixos/modules/services/web-apps/youtrack.md
Luke Granger-Brown 57725ef3ec Squashed 'third_party/nixpkgs/' content from commit 76612b17c0ce
git-subtree-dir: third_party/nixpkgs
git-subtree-split: 76612b17c0ce71689921ca12d9ffdc9c23ce40b2
2024-11-10 23:59:47 +00:00

2.1 KiB

YouTrack

YouTrack is a browser-based bug tracker, issue tracking system and project management software.

Installation

YouTrack exposes a web GUI installer on first login. You need a token to access it. You can find this token in the log of the youtrack service. The log line looks like

* JetBrains YouTrack 2023.3 Configuration Wizard will be available on [http://127.0.0.1:8090/?wizard_token=somelongtoken] after start

Upgrade from 2022.3 to 2023.x

Starting with YouTrack 2023.1, JetBrains no longer distributes it as as JAR. The new distribution with the JetBrains Launcher as a ZIP changed the basic data structure and also some configuration parameters. Check out https://www.jetbrains.com/help/youtrack/server/YouTrack-Java-Start-Parameters.html for more information on the new configuration options. When upgrading to YouTrack 2023.1 or higher, a migration script will move the old state directory to /var/lib/youtrack/2022_3 as a backup. A one-time manual update is required:

  1. Before you update take a backup of your YouTrack instance!
  2. Migrate the options you set in services.youtrack.extraParams and services.youtrack.jvmOpts to services.youtrack.generalParameters and services.youtrack.environmentalParameters (see the examples and the YouTrack docs)
  3. To start the upgrade set services.youtrack.package = pkgs.youtrack
  4. YouTrack then starts in upgrade mode, meaning you need to obtain the wizard token as above
  5. Select you want to Upgrade YouTrack
  6. As source you select /var/lib/youtrack/2022_3/teamsysdata/ (adopt if you have a different state path)
  7. Change the data directory location to /var/lib/youtrack/data/. The other paths should already be right.

If you migrate a larger YouTrack instance, it might be useful to set -Dexodus.entityStore.refactoring.forceAll=true in services.youtrack.generalParameters for the first startup of YouTrack 2023.x.