kybu / docker-youtrack

Docker image for Jetbrains Youtrack

docker-youtrack

Easy youtrack deployment using docker

These Dockerfiles allow you to easily build images to deploy your own youtrack instance.

Disclaimer

Besides that, as always, use these scripts with care.

Don't forget to back up your data very often, too.

Requirements

Docker has to run. It supports many platforms like Ubuntu, Arch Linux, Mac OS X, Windows, EC2 or the Google Cloud. Click here to get specific infos on how to install on your platform.

Oh nice! How do I do it?

1. Install docker. It's not very hard.
2. Run it! (Stop with CTRL-C, repeat at pleasure)

docker run -t -i -p 8080:8080 dzwicker/docker-youtrack

Now open your browser and point it to http://localhost:8080 and rejoice. :)

Do it as service in ubuntu/debian

1. Create directory to store data

mkdir -p /var/lib/youtrack
mkdir -p /var/log/youtrack
mkdir -p /etc/youtrack

2. Permissions!

The Dockerfile creates a youtrack user to run youtrack without root permissions. This user has a UID of 2000. Please make sure to add a user to your host system with this UID and allow him to read and write to /var/lib/youtrack. The name of this host user in not important. (You can use a the user group, too. It has the GID of 2000 :)

3. Create container!

   docker create -t -i -p 127.0.0.1:8080:8080 \
    	-v /var/lib/youtrack:/var/lib/youtrack \ 
    	-v /var/log/youtrack:/var/log/youtrack \
    	-v /etc/youtrack:/usr/local/youtrack/conf \
    	-v /tmp:/tmp \
    	--name docker-youtrack \
   dzwicker/docker-youtrack
   

4. Create upstart configuration /etc/init/docker-youtrack.conf

   description "Docker Youtrack"
   start on filesystem and started docker
   stop on runlevel [!2345]
   respawn
   script
     /usr/bin/docker start -a docker-youtrack >>/var/log/youtrack/docker-youtrack.log 2>&1
   end script
   

5. (optional) Setup logrotate e.g. /etc/logrotate.d/docker-youtrack

    /var/log/youtrack/*.log
    /var/log/youtrack/hub/*.log
    /var/log/youtrack/hub/logs/*.log
    /var/log/youtrack/youtrack/*.log
    /var/log/youtrack/youtrack/logs/*.log
    /var/log/youtrack/internal/services/bundleProcess/*.log
     {
        rotate 7
        daily
        missingok
        notifempty
        sharedscripts
        copytruncate
        compress
    }
   
   

6. (optional) Add vhost to nginx

   mkdir -p /var/log/nginx/your-domain

   upstream docker-youtrack {
     server localhost:8080;
   }
   
   server {
     listen 80;
     server_name           your-domain.com;
   
     access_log            /var/log/nginx/your-domain/access.log;
     error_log             /var/log/nginx/your-domain/error.log;
   
     proxy_set_header Host       $http_host;   # required for docker client's sake
     proxy_set_header X-Real-IP  $remote_addr; # pass on real client's IP
   
     client_max_body_size 0; # disable any limits to avoid HTTP 413 for large image uploads
   
     # required to avoid HTTP 411: see Issue #1486 (https://github.com/dotcloud/docker/issues/1486)
     chunked_transfer_encoding on;
   
     location / {
       proxy_pass http://docker-youtrack;
     }
   
   }
   

7. Configuring New YouTrack Server

   Follow the steps of the installation instructions for Jetbrains Youtrack using paths located under /var/lib/hub/data, /var/lib/hub/backups, /var/log/hub, /tmp.