gitlab 3.35 KB
Newer Older
Ben Bodenmiller's avatar
Ben Bodenmiller committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
## GitLab
## Maintainer: @randx
##
## Lines starting with two hashes (##) are comments with information.
## Lines starting with one hash (#) are configuration parameters that can be uncommented.
##
##################################
##        CHUNKED TRANSFER      ##
##################################
##
## It is a known issue that Git-over-HTTP requires chunked transfer encoding [0]
## which is not supported by Nginx < 1.3.9 [1]. As a result, pushing a large object
## with Git (i.e. a single large file) can lead to a 411 error. In theory you can get
## around this by tweaking this configuration file and either:
## - installing an old version of Nginx with the chunkin module [2] compiled in, or
## - using a newer version of Nginx.
##
## At the time of writing we do not know if either of these theoretical solutions works. 
## As a workaround users can use Git over SSH to push large files.
##
## [0] https://git.kernel.org/cgit/git/git.git/tree/Documentation/technical/http-protocol.txt#n99
## [1] https://github.com/agentzh/chunkin-nginx-module#status
## [2] https://github.com/agentzh/chunkin-nginx-module
##
###################################
##         configuration         ##
###################################
##
29

30
upstream gitlab {
31
  server unix:/home/git/gitlab/tmp/sockets/gitlab.socket fail_timeout=0;
32 33
}

Ben Bodenmiller's avatar
Ben Bodenmiller committed
34
## Normal HTTP host
35
server {
36 37 38
  listen *:80 default_server;
  server_name YOUR_SERVER_FQDN; ## Replace this with something like gitlab.example.com
  server_tokens off; ## Don't show the nginx version number, a security best practice
39
  root /home/git/gitlab/public;
Ben Bodenmiller's avatar
Ben Bodenmiller committed
40 41 42

  ## Increase this if you want to upload large attachments
  ## Or if you want to accept large git objects over http
43
  client_max_body_size 20m;
44

Ben Bodenmiller's avatar
Ben Bodenmiller committed
45
  ## Individual nginx logs for this GitLab vhost
46 47 48 49
  access_log  /var/log/nginx/gitlab_access.log;
  error_log   /var/log/nginx/gitlab_error.log;

  location / {
Ben Bodenmiller's avatar
Ben Bodenmiller committed
50 51
    ## Serve static files from defined root folder.
    ## @gitlab is a named location for the upstream fallback, see below.
52 53 54
    try_files $uri $uri/index.html $uri.html @gitlab;
  }

Ben Bodenmiller's avatar
Ben Bodenmiller committed
55 56
  ## If a file, which is not found in the root folder is requested,
  ## then the proxy passes the request to the upsteam (gitlab unicorn).
57
  location @gitlab {
Ben Bodenmiller's avatar
Ben Bodenmiller committed
58 59
    ## If you use HTTPS make sure you disable gzip compression
    ## to be safe against BREACH attack.
60
    # gzip off;
61

Ben Bodenmiller's avatar
Ben Bodenmiller committed
62 63 64 65 66
    ## https://github.com/gitlabhq/gitlabhq/issues/694
    ## Some requests take more than 30 seconds.
    proxy_read_timeout      300;
    proxy_connect_timeout   300;
    proxy_redirect          off;
67

Ben Bodenmiller's avatar
Ben Bodenmiller committed
68 69 70 71 72
    proxy_set_header    Host                $http_host;
    proxy_set_header    X-Real-IP           $remote_addr;
    proxy_set_header    X-Forwarded-For     $proxy_add_x_forwarded_for;
    proxy_set_header    X-Forwarded-Proto   $scheme;
    proxy_set_header    X-Frame-Options     SAMEORIGIN;
73 74 75

    proxy_pass http://gitlab;
  }
Jacob Vosmaer's avatar
Jacob Vosmaer committed
76

Ben Bodenmiller's avatar
Ben Bodenmiller committed
77 78 79 80 81 82
  ## Enable gzip compression as per rails guide:
  ## http://guides.rubyonrails.org/asset_pipeline.html#gzip-compression
  ## WARNING: If you are using relative urls remove the block below
  ## See config/application.rb under "Relative url support" for the list of
  ## other files that need to be changed for relative url support
  location ~ ^/(assets)/ {
83 84 85 86 87 88
    root /home/git/gitlab/public;
    gzip_static on; # to serve pre-gzipped version
    expires max;
    add_header Cache-Control public;
  }

Jacob Vosmaer's avatar
Jacob Vosmaer committed
89
  error_page 502 /502.html;
90
}