[{"data":1,"prerenderedAt":2187},["ShallowReactive",2],{"/blog/tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt":3,"navigation-en-us":1400,"banner-en-us":1826,"footer-en-us":1836,"blog-post-authors-en-us-Guest author André Miranda":2081,"blog-related-posts-en-us-tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt":2097,"blog-promotions-en-us":2123,"next-steps-en-us":2177},{"id":4,"title":5,"authors":6,"body":8,"category":1376,"date":1377,"description":1378,"extension":1379,"externalUrl":1380,"faq":1380,"featured":1381,"heroImage":1382,"meta":1383,"navigation":673,"path":1391,"seo":1392,"slug":1396,"stem":1397,"tags":1380,"template":1398,"updatedDate":1380,"__hash__":1399},"blogPosts/en-us/blog/tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt.md","Tutorial: Securing your GitLab Pages with TLS and Let's Encrypt",[7],"Guest author André Miranda",{"type":9,"value":10,"toc":1363},"minimark",[11,22,27,30,39,57,79,83,86,99,103,111,124,128,142,145,204,217,228,237,279,286,390,404,421,425,428,442,451,466,486,495,506,513,539,561,564,616,619,715,718,721,765,796,820,833,873,876,895,902,909,917,920,923,952,959,962,1025,1029,1036,1041,1048,1082,1085,1089,1092,1101,1153,1157,1164,1167,1170,1267,1270,1287,1291,1297,1300,1319,1339,1348,1356,1359],[12,13,14,15,21],"p",{},"In this post we will talk about HTTPS and how to add it to your GitLab Pages site\nwith ",[16,17,20],"a",{"href":18,"rel":19},"https://letsencrypt.org/",[],"Let's Encrypt",".",[23,24,26],"h2",{"id":25},"why-tlsssl","Why TLS/SSL?",[12,28,29],{},"When discussing HTTPS, it's common to hear people saying that a static\nwebsite doesn't need HTTPS, since it doesn't receive any POST requests, or isn't\nhandling credit card transactions or any other secure request.\nBut that's not the whole story.",[12,31,32,33,38],{},"TLS (",[16,34,37],{"href":35,"rel":36},"https://en.wikipedia.org/wiki/Transport_Layer_Security#TLS_1.0",[],"formerly SSL",") is a security protocol that can be added to HTTP\nto increase the security of your website by:",[40,41,42,51,54],"ol",{},[43,44,45,46,50],"li",{},"properly authenticating yourself: the client can trust that you are really\n",[47,48,49],"strong",{},"you",". The TLS handshake that is made at the beginning of the connection\nensures the client that no one is trying to impersonate you;",[43,52,53],{},"data integrity: this ensures that no one has tampered with the data in a\nrequest/response cycle;",[43,55,56],{},"encryption: this is the main selling point of TLS, but the\nother two are just as important. This protects the privacy of the communication\nbetween client and server.",[12,58,59,60,65,66,70,71,78],{},"The TLS layer can be added to other protocols too, such as FTP (making it\n",[16,61,64],{"href":62,"rel":63},"https://en.wikipedia.org/wiki/FTPS",[],"FTPS",") or WebSockets\n(making ",[67,68,69],"code",{},"ws://"," ",[16,72,75],{"href":73,"rel":74},"https://devcenter.heroku.com/articles/websocket-security#wss",[],[67,76,77],{},"wss://",").",[23,80,82],{"id":81},"https-everywhere","HTTPS Everywhere",[12,84,85],{},"Nowadays, there is a strong push for using TLS on every website.\nThe ultimate goal is to make the web safer, by adding those three components\ncited above to every website.",[12,87,88,89,93,94,21],{},"The first big player was the ",[16,90,82],{"href":91,"rel":92},"https://www.eff.org/https-everywhere",[],"\nbrowser extension. Google has also been using HTTPS compliance to better\nrank websites since ",[16,95,98],{"href":96,"rel":97},"https://webmasters.googleblog.com/2014/08/https-as-ranking-signal.html",[],"2014",[23,100,102],{"id":101},"how-to-get-tls-certificates","How to get TLS certificates",[12,104,105,106,21],{},"In order to add TLS to HTTP, one would need to get a certificate, and until 2015,\none would need to either pay for it or figure out how to do it with one of the\navailable ",[16,107,110],{"href":108,"rel":109},"https://en.wikipedia.org/wiki/Certificate_authority",[],"Certificate Authorities",[12,112,113,114,117,118,123],{},"Enter ",[16,115,20],{"href":18,"rel":116},[],", a free, automated, and open Certificate Authority.\nSince ",[16,119,122],{"href":120,"rel":121},"https://letsencrypt.org/2015/12/03/entering-public-beta.html",[],"December 2015"," anyone can get a free certificate from this\nnew Certificate Authority from the comfort of their terminal.",[23,125,127],{"id":126},"implementation","Implementation",[12,129,130,131,136,137,21],{},"So, let's suppose we're going to create a static blog with ",[16,132,135],{"href":133,"rel":134},"https://jekyllrb.com/",[],"Jekyll 3",".\nIf you are not creating a blog or are not using Jekyll just follow along, it\nshould be straightforward enough to translate the steps for different purposes.\nYou can also find many example projects using different static site generators\n(like Middleman or Hugo) in ",[16,138,141],{"href":139,"rel":140},"https://gitlab.com/groups/pages",[],"GitLab's example projects",[12,143,144],{},"A simple example blog can be created with:",[146,147,152],"pre",{"className":148,"code":149,"language":150,"meta":151,"style":151},"language-shell shiki shiki-themes github-light","$ jekyll new cool-blog\nNew jekyll site installed in ~/cool-blog.\n$ cd cool-blog/\n","shell","",[67,153,154,173,193],{"__ignoreMap":151},[155,156,159,163,167,170],"span",{"class":157,"line":158},"line",1,[155,160,162],{"class":161},"s7eDp","$",[155,164,166],{"class":165},"sYBdl"," jekyll",[155,168,169],{"class":165}," new",[155,171,172],{"class":165}," cool-blog\n",[155,174,176,179,181,184,187,190],{"class":157,"line":175},2,[155,177,178],{"class":161},"New",[155,180,166],{"class":165},[155,182,183],{"class":165}," site",[155,185,186],{"class":165}," installed",[155,188,189],{"class":165}," in",[155,191,192],{"class":165}," ~/cool-blog.\n",[155,194,196,198,201],{"class":157,"line":195},3,[155,197,162],{"class":161},[155,199,200],{"class":165}," cd",[155,202,203],{"class":165}," cool-blog/\n",[12,205,206,207,210,211,216],{},"Now you have to create a GitLab project. Here we are going to create a \"user\npage\", which means that it is a project created within a user account (not a\ngroup account), and that the name of the project looks like ",[67,208,209],{},"YOURUSERNAME.gitlab.io",".\nRefer to the ",[16,212,215],{"href":213,"rel":214},"https://docs.gitlab.com/pages/README/#getting-started-with-gitlab-pages",[],"\"Getting started\" section of the GitLab Pages manual","\nfor more information on that.",[12,218,219,220,223,224,227],{},"From now on, remember to replace ",[67,221,222],{},"YOURDOMAIN.org"," with your custom domain and\n",[67,225,226],{},"YOURUSERNAME"," with, well, your username. ;)",[12,229,230,233,234,236],{},[155,231,232],{},"Create a project"," named ",[67,235,209],{}," so that GitLab will\nidentify the project correctly. After that, upload your code to GitLab:",[146,238,240],{"className":148,"code":239,"language":150,"meta":151,"style":151},"$ git remote add origin git@gitlab.com:YOURUSERNAME/YOURUSERNAME.gitlab.io.git\n$ git push -u origin master\n",[67,241,242,261],{"__ignoreMap":151},[155,243,244,246,249,252,255,258],{"class":157,"line":158},[155,245,162],{"class":161},[155,247,248],{"class":165}," git",[155,250,251],{"class":165}," remote",[155,253,254],{"class":165}," add",[155,256,257],{"class":165}," origin",[155,259,260],{"class":165}," git@gitlab.com:YOURUSERNAME/YOURUSERNAME.gitlab.io.git\n",[155,262,263,265,267,270,274,276],{"class":157,"line":175},[155,264,162],{"class":161},[155,266,248],{"class":165},[155,268,269],{"class":165}," push",[155,271,273],{"class":272},"sYu0t"," -u",[155,275,257],{"class":165},[155,277,278],{"class":165}," master\n",[12,280,281,282,285],{},"OK, so far we have a project uploaded to GitLab, but we haven't configured GitLab Pages yet.\nTo configure it, just create a ",[67,283,284],{},".gitlab-ci.yml"," file in the root directory of your repository\nwith the following contents:",[146,287,291],{"className":288,"code":289,"language":290,"meta":151,"style":151},"language-yaml shiki shiki-themes github-light","pages:\n  stage: deploy\n  image: ruby:2.3\n  script:\n    - gem install jekyll\n    - jekyll build -d public/\n  artifacts:\n    paths:\n      - public\n  only:\n    - master\n\n","yaml",[67,292,293,303,314,324,332,341,349,357,365,374,382],{"__ignoreMap":151},[155,294,295,299],{"class":157,"line":158},[155,296,298],{"class":297},"shJU0","pages",[155,300,302],{"class":301},"sgsFI",":\n",[155,304,305,308,311],{"class":157,"line":175},[155,306,307],{"class":297},"  stage",[155,309,310],{"class":301},": ",[155,312,313],{"class":165},"deploy\n",[155,315,316,319,321],{"class":157,"line":195},[155,317,318],{"class":297},"  image",[155,320,310],{"class":301},[155,322,323],{"class":165},"ruby:2.3\n",[155,325,327,330],{"class":157,"line":326},4,[155,328,329],{"class":297},"  script",[155,331,302],{"class":301},[155,333,335,338],{"class":157,"line":334},5,[155,336,337],{"class":301},"    - ",[155,339,340],{"class":165},"gem install jekyll\n",[155,342,344,346],{"class":157,"line":343},6,[155,345,337],{"class":301},[155,347,348],{"class":165},"jekyll build -d public/\n",[155,350,352,355],{"class":157,"line":351},7,[155,353,354],{"class":297},"  artifacts",[155,356,302],{"class":301},[155,358,360,363],{"class":157,"line":359},8,[155,361,362],{"class":297},"    paths",[155,364,302],{"class":301},[155,366,368,371],{"class":157,"line":367},9,[155,369,370],{"class":301},"      - ",[155,372,373],{"class":165},"public\n",[155,375,377,380],{"class":157,"line":376},10,[155,378,379],{"class":297},"  only",[155,381,302],{"class":301},[155,383,385,387],{"class":157,"line":384},11,[155,386,337],{"class":301},[155,388,389],{"class":165},"master\n",[12,391,392,393,396,397,400,401,78],{},"This file instructs GitLab Runner to ",[67,394,395],{},"deploy"," by installing Jekyll and\nbuilding your website under the ",[67,398,399],{},"public/"," folder\n(",[67,402,403],{},"jekyll build -d public/",[12,405,406,407,410,411,414,415,420],{},"While you Wait for the build process to complete, you can track the progress in the\nBuilds page of your project. Once it starts, it probably won't take longer\nthan a few minutes. Once the build is finished, your website will be available at\n",[67,408,409],{},"https://YOURUSERNAME.gitlab.io",". Note that GitLab already provides TLS\ncertificates to all subdomains of ",[67,412,413],{},"gitlab.io"," (but it has some limitations, so\nplease ",[16,416,419],{"href":417,"rel":418},"https://docs.gitlab.com/pages/README/#limitations",[],"refer to the documentation for more","). So if you don't want to add a\ncustom domain, you're done.",[23,422,424],{"id":423},"how-to-configure-the-tls-certificate-of-your-custom-domain","How to configure the TLS certificate of your custom domain.",[12,426,427],{},"Once you buy a domain name and point that domain to your GitLab Pages website,\nyou need to configure 2 things:",[40,429,430,439],{},[43,431,432,433,438],{},"add the domain to GitLab Pages configuration (",[16,434,437],{"href":435,"rel":436},"https://docs.gitlab.com/pages/README/#add-a-custom-domain-to-your-pages-website",[],"see documentation",");",[43,440,441],{},"add your custom certificate to your website.",[12,443,444,445,448,449,21],{},"Once you add your domain, your website will be available under both\n",[67,446,447],{},"http://YOURDOMAIN.org"," and ",[67,450,409],{},[12,452,453,454,457,458,461,462],{},"But if you try to access your custom domain with ",[67,455,456],{},"HTTPS","\n(",[67,459,460],{},"https://YOURDOMAIN.org"," in this case), your browser will show that\nhorrible page, saying that things are going wrong and someone is trying to\nsteal your information. ",[463,464,465],"em",{},"Why is that?",[12,467,468,469,471,472,475,476,478,479,481,482,485],{},"Since GitLab offers TLS certificates to all ",[67,470,413],{}," pages\nand your custom domain is just a ",[67,473,474],{},"CNAME"," over that same domain, GitLab serves\nthe ",[67,477,413],{}," certificate, and your browser receives mixed messages: on one\nside, the browser is trying to access ",[67,480,222],{},", but on the other side\nit is getting a TLS certificate for ",[67,483,484],{},"*.gitlab.io",",\nsignaling that something is wrong.",[12,487,488,489,491,492,21],{},"In order to fix it, you need to obtain a certificate for ",[67,490,222],{}," and\nadd it to GitLab Pages. For that we are going to use\n",[16,493,20],{"href":18,"rel":494},[],[12,496,497,498,501,502,505],{},"Let's Encrypt is a new certificate authority that offers both ",[463,499,500],{},"free"," and\n",[463,503,504],{},"automated"," certificates. That's perfect for us: we don't have to pay for\nhaving HTTPS and you can do everything within the comfort of your terminal.",[12,507,508,509,512],{},"We begin with downloading the ",[67,510,511],{},"letsencrypt-auto"," utility.\nOpen a new terminal window and type:",[146,514,516],{"className":148,"code":515,"language":150,"meta":151,"style":151},"$ git clone https://github.com/letsencrypt/letsencrypt\n$ cd letsencrypt\n",[67,517,518,530],{"__ignoreMap":151},[155,519,520,522,524,527],{"class":157,"line":158},[155,521,162],{"class":161},[155,523,248],{"class":165},[155,525,526],{"class":165}," clone",[155,528,529],{"class":165}," https://github.com/letsencrypt/letsencrypt\n",[155,531,532,534,536],{"class":157,"line":175},[155,533,162],{"class":161},[155,535,200],{"class":165},[155,537,538],{"class":165}," letsencrypt\n",[12,540,541,543,544,547,548,551,552,554,555,560],{},[67,542,511],{}," offers a lot of functionality. For example, if you have\na web server running Apache, you could add ",[67,545,546],{},"letsencrypt-auto --apache"," inside your\nwebserver and have everything done for you. ",[67,549,550],{},"letsencrypt"," targets primarily Unix-like\nwebservers, so the ",[67,553,511],{}," tool won't work for Windows users. Check ",[16,556,559],{"href":557,"rel":558},"https://cultiv.nl/blog/lets-encrypt-on-windows/",[],"this\ntutorial"," to see how to get Let's Encrypt certificates while running\nWindows.",[12,562,563],{},"Since we are running on GitLab's servers instead, we have to do a bit of manual\nwork:",[146,565,567],{"className":148,"code":566,"language":150,"meta":151,"style":151},"$ ./letsencrypt-auto certonly -a manual -d YOURDOMAIN.org\n#\n# If you want to support another domain, www.YOURDOMAIN.org, for example, you\n# can add it to the domain list after -d like:\n# ./letsencrypt-auto certonly -a manual -d YOURDOMAIN.org www.YOURDOMAIN.org\n#\n",[67,568,569,591,597,602,607,612],{"__ignoreMap":151},[155,570,571,573,576,579,582,585,588],{"class":157,"line":158},[155,572,162],{"class":161},[155,574,575],{"class":165}," ./letsencrypt-auto",[155,577,578],{"class":165}," certonly",[155,580,581],{"class":272}," -a",[155,583,584],{"class":165}," manual",[155,586,587],{"class":272}," -d",[155,589,590],{"class":165}," YOURDOMAIN.org\n",[155,592,593],{"class":157,"line":175},[155,594,596],{"class":595},"sAwPA","#\n",[155,598,599],{"class":157,"line":195},[155,600,601],{"class":595},"# If you want to support another domain, www.YOURDOMAIN.org, for example, you\n",[155,603,604],{"class":157,"line":326},[155,605,606],{"class":595},"# can add it to the domain list after -d like:\n",[155,608,609],{"class":157,"line":334},[155,610,611],{"class":595},"# ./letsencrypt-auto certonly -a manual -d YOURDOMAIN.org www.YOURDOMAIN.org\n",[155,613,614],{"class":157,"line":343},[155,615,596],{"class":595},[12,617,618],{},"After you accept that your IP will be publicly logged, a message like the\nfollowing will appear:",[146,620,622],{"className":148,"code":621,"language":150,"meta":151,"style":151},"Make sure your web server displays the following content at\nhttp://YOURDOMAIN.org/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM\nbefore continuing:\n\n5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.ewlbSYgvIxVOqiP1lD2zeDKWBGEZMRfO_4kJyLRP_4U\n\n#\n# output omitted\n#\n\nPress ENTER to continue\n",[67,623,624,656,661,669,675,680,684,688,693,697,701],{"__ignoreMap":151},[155,625,626,629,632,635,638,641,644,647,650,653],{"class":157,"line":158},[155,627,628],{"class":161},"Make",[155,630,631],{"class":165}," sure",[155,633,634],{"class":165}," your",[155,636,637],{"class":165}," web",[155,639,640],{"class":165}," server",[155,642,643],{"class":165}," displays",[155,645,646],{"class":165}," the",[155,648,649],{"class":165}," following",[155,651,652],{"class":165}," content",[155,654,655],{"class":165}," at\n",[155,657,658],{"class":157,"line":175},[155,659,660],{"class":161},"http://YOURDOMAIN.org/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM\n",[155,662,663,666],{"class":157,"line":195},[155,664,665],{"class":161},"before",[155,667,668],{"class":165}," continuing:\n",[155,670,671],{"class":157,"line":326},[155,672,674],{"emptyLinePlaceholder":673},true,"\n",[155,676,677],{"class":157,"line":334},[155,678,679],{"class":161},"5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.ewlbSYgvIxVOqiP1lD2zeDKWBGEZMRfO_4kJyLRP_4U\n",[155,681,682],{"class":157,"line":343},[155,683,674],{"emptyLinePlaceholder":673},[155,685,686],{"class":157,"line":351},[155,687,596],{"class":595},[155,689,690],{"class":157,"line":359},[155,691,692],{"class":595},"# output omitted\n",[155,694,695],{"class":157,"line":367},[155,696,596],{"class":595},[155,698,699],{"class":157,"line":376},[155,700,674],{"emptyLinePlaceholder":673},[155,702,703,706,709,712],{"class":157,"line":384},[155,704,705],{"class":161},"Press",[155,707,708],{"class":165}," ENTER",[155,710,711],{"class":165}," to",[155,713,714],{"class":165}," continue\n",[12,716,717],{},"Now it is waiting for the server to be correctly configured so it can go on.\nLeave this terminal window open for now.",[12,719,720],{},"So, the goal is to the make our already-published static website return\nsaid token when said URL is requested. That's easy: create a custom\npage! Just create a file in your blog folder that looks like this:",[146,722,726],{"className":723,"code":724,"language":725,"meta":151,"style":151},"language-markdown shiki shiki-themes github-light","---\nlayout: null\npermalink: /.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.html\n---\n\n5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.ewlbSYgvIxVOqiP1lD2zeDKWBGEZMRfO_4kJyLRP_4U\n","markdown",[67,727,728,733,743,753,757,761],{"__ignoreMap":151},[155,729,730],{"class":157,"line":158},[155,731,732],{"class":301},"---\n",[155,734,735,738,740],{"class":157,"line":175},[155,736,737],{"class":297},"layout",[155,739,310],{"class":301},[155,741,742],{"class":272},"null\n",[155,744,745,748,750],{"class":157,"line":195},[155,746,747],{"class":297},"permalink",[155,749,310],{"class":301},[155,751,752],{"class":165},"/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.html\n",[155,754,755],{"class":157,"line":326},[155,756,732],{"class":301},[155,758,759],{"class":157,"line":334},[155,760,674],{"emptyLinePlaceholder":673},[155,762,763],{"class":157,"line":343},[155,764,679],{"class":301},[12,766,767,768,771,772,774,775,777,778,783,784,787,788,791,792,795],{},"This tells Jekyll to create a static page, which you can see at\n",[67,769,770],{},"cool-blog/_site/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.html",",\nwith no extra HTML, just the token in plain text. As we are using the ",[67,773,747],{}," attribute in the\nfront matter, you can name this file anyway you want and put it anywhere, too.\nNote that the behaviour of the ",[67,776,747],{}," attribute has\n",[16,779,782],{"href":780,"rel":781},"https://jekyllrb.com/docs/upgrading/2-to-3/#permalinks-no-longer-automatically-add-a-trailing-slash",[],"changed"," from Jekyll 2 to Jekyll 3, so make sure you have Jekyll 3.x installed.\nIf you're not using version 3 of Jekyll or if you're using a different tool,\njust create the same file in the exact path, like\n",[67,785,786],{},"cool-blog/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.html","\nor an equivalent path in your static site generator of choice.\nHere we'll call it ",[67,789,790],{},"letsencrypt-setup.html"," and place it in the root folder\nof the blog. In order to check that everything is working as expected, start a local server with ",[67,793,794],{},"jekyll serve"," in a separate terminal window and try to access the URL:",[146,797,799],{"className":148,"code":798,"language":150,"meta":151,"style":151},"$ curl http://localhost:4000/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM\n# response:\n5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM.ewlbSYgvIxVOqiP1lD2zeDKWBGEZMRfO_4kJyLRP_4U\n",[67,800,801,811,816],{"__ignoreMap":151},[155,802,803,805,808],{"class":157,"line":158},[155,804,162],{"class":161},[155,806,807],{"class":165}," curl",[155,809,810],{"class":165}," http://localhost:4000/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM\n",[155,812,813],{"class":157,"line":175},[155,814,815],{"class":595},"# response:\n",[155,817,818],{"class":157,"line":195},[155,819,679],{"class":161},[12,821,822,823,825,826,828,829,832],{},"Note that I just replaced the ",[67,824,447],{}," (from the\n",[67,827,511],{}," instructions) with ",[67,830,831],{},"http://localhost:4000",".\nEverything is working fine, so we just need to upload the new file to GitLab:",[146,834,836],{"className":148,"code":835,"language":150,"meta":151,"style":151},"$ git add letsencrypt-setup.html\n$ git commit -m \"add letsencypt-setup.html file\"\n$ git push\n",[67,837,838,849,864],{"__ignoreMap":151},[155,839,840,842,844,846],{"class":157,"line":158},[155,841,162],{"class":161},[155,843,248],{"class":165},[155,845,254],{"class":165},[155,847,848],{"class":165}," letsencrypt-setup.html\n",[155,850,851,853,855,858,861],{"class":157,"line":175},[155,852,162],{"class":161},[155,854,248],{"class":165},[155,856,857],{"class":165}," commit",[155,859,860],{"class":272}," -m",[155,862,863],{"class":165}," \"add letsencypt-setup.html file\"\n",[155,865,866,868,870],{"class":157,"line":195},[155,867,162],{"class":161},[155,869,248],{"class":165},[155,871,872],{"class":165}," push\n",[12,874,875],{},"Once the build finishes, test again if everything is working well:",[146,877,879],{"className":148,"code":878,"language":150,"meta":151,"style":151},"# Note that we're using the actual domain, not localhost anymore\n$ curl http://YOURDOMAIN.org/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM\n",[67,880,881,886],{"__ignoreMap":151},[155,882,883],{"class":157,"line":158},[155,884,885],{"class":595},"# Note that we're using the actual domain, not localhost anymore\n",[155,887,888,890,892],{"class":157,"line":175},[155,889,162],{"class":161},[155,891,807],{"class":165},[155,893,894],{"class":165}," http://YOURDOMAIN.org/.well-known/acme-challenge/5TBu788fW0tQ5EOwZMdu1Gv3e9C33gxjV58hVtWTbDM\n",[12,896,897,898,901],{},"If you get a ",[67,899,900],{},"404 page not found",", check if you missed any step, or get in touch\nin the comments below.",[12,903,904,905,908],{},"Now that everything is working as expected, go back to the terminal window\nthat's waiting for you and hit ",[67,906,907],{},"ENTER",". This instructs the Let's Encrypt's\nservers to go to the URL we just created. If they get the response they were waiting for,\nwe've proven that we actually own the domain and now they'll send you the\nTLS certificates. After a while it responds:",[146,910,915],{"className":911,"code":913,"language":914,"meta":151},[912],"language-text","IMPORTANT NOTES:\n - Congratulations! Your certificate and chain have been saved at\n   /etc/letsencrypt/live/YOURDOMAIN.org/fullchain.pem. Your cert will\n   expire on 2016-07-04. To obtain a new version of the certificate in\n   the future, simply run Let's Encrypt again.\n - If you like Let's Encrypt, please consider supporting our work by:\n\n   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate\n   Donating to EFF:                    https://eff.org/donate-le\n\n","text",[67,916,913],{"__ignoreMap":151},[12,918,919],{},"Success! We have correctly acquired a free TLS certificate for our domain!",[12,921,922],{},"Note, however, that like any other TLS certificate, it has an expiration date,\nand in the case of certificates issued by Let's Encrypt, the certificate will\nremain valid for 90 days. When you finish setting up, just put in your calendar to\nremember to renew the certificate in time, otherwise it will become invalid,\nand the browser will reject it.",[12,924,925,926,929,930,933,934,936,937,940,941,944,945,948,949,951],{},"Now we just need to upload the certificate and the key to GitLab.\nGo to ",[47,927,928],{},"Settings"," -> ",[47,931,932],{},"Pages"," inside your project, remove the old ",[67,935,474],{}," and\nadd a new one with the same domain, but now you'll also upload the TLS\ncertificate. Paste the contents of ",[67,938,939],{},"/etc/letsencrypt/live/YOURDOMAIN.org/fullchain.pem","\n(you'll need ",[67,942,943],{},"sudo"," to read the file) to the \"Certificate (PEM)\"\nfield and ",[67,946,947],{},"/etc/letsencrypt/live/YOURDOMAIN.org/privkey.pem"," (also needs ",[67,950,943],{},") to the\n\"Key (PEM)\" field.",[12,953,954],{},[955,956],"img",{"alt":957,"src":958},"Uploading the certificate to GitLab Pages","https://res.cloudinary.com/about-gitlab-com/image/upload/v1782398420/blog/Content%20Images/gitlab-pages-cert-upload-screenshot.png",[12,960,961],{},"And you're done! You now have a fully working HTTPS website:",[146,963,965],{"className":148,"code":964,"language":150,"meta":151,"style":151},"$ curl -vX HEAD https://YOURDOMAIN.org/\n#\n# starting connection\n#\n* TLS 1.2 connection using TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA\n* Server certificate: YOURDOMAIN.org\n* Server certificate: Lets Encrypt Authority X3\n* Server certificate: DST Root CA X3\n",[67,966,967,982,986,991,995,1004,1011,1018],{"__ignoreMap":151},[155,968,969,971,973,976,979],{"class":157,"line":158},[155,970,162],{"class":161},[155,972,807],{"class":165},[155,974,975],{"class":272}," -vX",[155,977,978],{"class":165}," HEAD",[155,980,981],{"class":165}," https://YOURDOMAIN.org/\n",[155,983,984],{"class":157,"line":175},[155,985,596],{"class":595},[155,987,988],{"class":157,"line":195},[155,989,990],{"class":595},"# starting connection\n",[155,992,993],{"class":157,"line":326},[155,994,596],{"class":595},[155,996,997,1001],{"class":157,"line":334},[155,998,1000],{"class":999},"sD7c4","*",[155,1002,1003],{"class":301}," TLS 1.2 connection using TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA\n",[155,1005,1006,1008],{"class":157,"line":343},[155,1007,1000],{"class":999},[155,1009,1010],{"class":301}," Server certificate: YOURDOMAIN.org\n",[155,1012,1013,1015],{"class":157,"line":351},[155,1014,1000],{"class":999},[155,1016,1017],{"class":301}," Server certificate: Lets Encrypt Authority X3\n",[155,1019,1020,1022],{"class":157,"line":359},[155,1021,1000],{"class":999},[155,1023,1024],{"class":301}," Server certificate: DST Root CA X3\n",[23,1026,1028],{"id":1027},"how-to-redirect-all-traffic-to-the-https-version","How to redirect all traffic to the HTTPS version",[12,1030,1031,1032,1035],{},"Everything is working fine, but now we have an extra concern: we have two\nworking versions of our website, both HTTP ",[47,1033,1034],{},"and"," HTTPS. We need a way to\nredirect all of our traffic to the HTTPS version, and tell search engines to\ndo the same.",[1037,1038,1040],"h3",{"id":1039},"how-to-tell-search-engines-which-is-the-correct-version","How to tell search engines which is the correct version",[12,1042,1043,1044,1047],{},"Instructing the search engines is really easy: just tell them that the HTTPS\nversion is the \"canonical\" version, and they send all the users to it.\nAnd how do you do that? By adding a ",[67,1045,1046],{},"link"," tag to the header of the HTML:",[146,1049,1053],{"className":1050,"code":1051,"language":1052,"meta":151,"style":151},"language-html shiki shiki-themes github-light","\u003Clink rel=\"canonical\" href=\"https://YOURDOMAIN.org/specific/page\" />\n","html",[67,1054,1055],{"__ignoreMap":151},[155,1056,1057,1060,1062,1065,1068,1071,1074,1076,1079],{"class":157,"line":158},[155,1058,1059],{"class":301},"\u003C",[155,1061,1046],{"class":297},[155,1063,1064],{"class":161}," rel",[155,1066,1067],{"class":301},"=",[155,1069,1070],{"class":165},"\"canonical\"",[155,1072,1073],{"class":161}," href",[155,1075,1067],{"class":301},[155,1077,1078],{"class":165},"\"https://YOURDOMAIN.org/specific/page\"",[155,1080,1081],{"class":301}," />\n",[12,1083,1084],{},"Adding this to every header on a blog tells the search engine that the correct\nversion is the HTTPS one, and they'll comply.",[1037,1086,1088],{"id":1087},"internal-links","Internal links",[12,1090,1091],{},"Remember to use HTTPS for your CSS or JavaScript file URLs, because when the\nbrowser accesses a secure website that relies on an insecure resource, it may\nblock that resource.",[12,1093,1094,1095,1100],{},"It is ",[16,1096,1099],{"href":1097,"rel":1098},"http://www.paulirish.com/2010/the-protocol-relative-url/",[],"considered a good practice"," to use the protocol-agnostic path:",[146,1102,1106],{"className":1103,"code":1104,"language":1105,"meta":151,"style":151},"language-xml shiki shiki-themes github-light","\u003Clink rel=\"stylesheet\" href=\"//YOURDOMAIN.org/styles.css\" />\n\u003Cscript src=\"//YOURDOMAIN.org/script.js\">\u003C/script>\n","xml",[67,1107,1108,1130],{"__ignoreMap":151},[155,1109,1110,1112,1114,1116,1118,1121,1123,1125,1128],{"class":157,"line":158},[155,1111,1059],{"class":301},[155,1113,1046],{"class":297},[155,1115,1064],{"class":161},[155,1117,1067],{"class":301},[155,1119,1120],{"class":165},"\"stylesheet\"",[155,1122,1073],{"class":161},[155,1124,1067],{"class":301},[155,1126,1127],{"class":165},"\"//YOURDOMAIN.org/styles.css\"",[155,1129,1081],{"class":301},[155,1131,1132,1134,1137,1140,1142,1145,1148,1150],{"class":157,"line":175},[155,1133,1059],{"class":301},[155,1135,1136],{"class":297},"script",[155,1138,1139],{"class":161}," src",[155,1141,1067],{"class":301},[155,1143,1144],{"class":165},"\"//YOURDOMAIN.org/script.js\"",[155,1146,1147],{"class":301},">\u003C/",[155,1149,1136],{"class":297},[155,1151,1152],{"class":301},">\n",[1037,1154,1156],{"id":1155},"when-to-use-javascript-based-redirect","When to use JavaScript-based redirect",[12,1158,1159,1160,1163],{},"There is, however, a case where the user specifically types in the URL\n",[47,1161,1162],{},"without"," using HTTPS, and they'll access the HTTP version of your website.",[12,1165,1166],{},"The correct way of handling that would be to respond with a 301 \"Moved\npermanently\" HTTP code, and the browser would remember it for the next request.\nHowever, that's not a possibility we have here, since we're running on GitLab's servers.",[12,1168,1169],{},"A small hack you can do is to redirect your users with a bit of JavaScript code:",[146,1171,1175],{"className":1172,"code":1173,"language":1174,"meta":151,"style":151},"language-javascript shiki shiki-themes github-light","var host = \"YOURDOMAIN.org\";\nif ((host == window.location.host) && (window.location.protocol != 'https:')) {\n  window.location = window.location.toString().replace(/^http:/, \"https:\");\n}\n","javascript",[67,1176,1177,1193,1222,1262],{"__ignoreMap":151},[155,1178,1179,1182,1185,1187,1190],{"class":157,"line":158},[155,1180,1181],{"class":999},"var",[155,1183,1184],{"class":301}," host ",[155,1186,1067],{"class":999},[155,1188,1189],{"class":165}," \"YOURDOMAIN.org\"",[155,1191,1192],{"class":301},";\n",[155,1194,1195,1198,1201,1204,1207,1210,1213,1216,1219],{"class":157,"line":175},[155,1196,1197],{"class":999},"if",[155,1199,1200],{"class":301}," ((host ",[155,1202,1203],{"class":999},"==",[155,1205,1206],{"class":301}," window.location.host) ",[155,1208,1209],{"class":999},"&&",[155,1211,1212],{"class":301}," (window.location.protocol ",[155,1214,1215],{"class":999},"!=",[155,1217,1218],{"class":165}," 'https:'",[155,1220,1221],{"class":301},")) {\n",[155,1223,1224,1227,1229,1232,1235,1238,1241,1244,1247,1250,1253,1256,1259],{"class":157,"line":195},[155,1225,1226],{"class":301},"  window.location ",[155,1228,1067],{"class":999},[155,1230,1231],{"class":301}," window.location.",[155,1233,1234],{"class":161},"toString",[155,1236,1237],{"class":301},"().",[155,1239,1240],{"class":161},"replace",[155,1242,1243],{"class":301},"(",[155,1245,1246],{"class":165},"/",[155,1248,1249],{"class":999},"^",[155,1251,1252],{"class":165},"http:/",[155,1254,1255],{"class":301},", ",[155,1257,1258],{"class":165},"\"https:\"",[155,1260,1261],{"class":301},");\n",[155,1263,1264],{"class":157,"line":326},[155,1265,1266],{"class":301},"}\n",[12,1268,1269],{},"This redirects the user to the HTTPS version, but there are a few problems with it:",[40,1271,1272,1275,1284],{},[43,1273,1274],{},"a user could have JavaScript disabled, and would not be affected by that;",[43,1276,1277,1278,1283],{},"an attacker could simply remove that code and behave as a ",[16,1279,1282],{"href":1280,"rel":1281},"https://en.wikipedia.org/wiki/Man-in-the-middle_attack",[],"Man in the Middle",";",[43,1285,1286],{},"the browser won't remember the redirect instruction, so every time the user types\nthat same URL, the website will have to redirect him/her again.",[23,1288,1290],{"id":1289},"wrap-up","Wrap up",[12,1292,1293],{},[955,1294],{"alt":1295,"src":1296},"a working certificate screenshot","https://res.cloudinary.com/about-gitlab-com/image/upload/v1782399335/blog/Content%20Images/working-certificate-screenshot.png",[12,1298,1299],{},"That's how easy it is to have a free HTTPS-enabled website.\nWith these tools, I see no reason not to do it.",[12,1301,1302,1303,1255,1308,501,1313,1318],{},"If you want to improve GitLab's support for Let's Encrypt, you can\ndiscuss and contribute in issues ",[16,1304,1307],{"href":1305,"rel":1306},"https://gitlab.com/gitlab-org/gitlab-ee/issues/474",[],"#474",[16,1309,1312],{"href":1310,"rel":1311},"https://gitlab.com/gitlab-org/gitlab-ee/issues/467",[],"#467",[16,1314,1317],{"href":1315,"rel":1316},"https://gitlab.com/gitlab-org/gitlab-ee/issues/472",[],"#472"," from GitLab EE. They are open to merge requests!",[12,1320,1321,1322,1327,1328,501,1333,1338],{},"There's an ",[16,1323,1326],{"href":1324,"rel":1325},"https://www.youtube.com/watch?v=cBhZ6S0PFCY",[],"excellent talk"," by ",[16,1329,1332],{"href":1330,"rel":1331},"https://twitter.com/pierrefar",[],"Pierre Far",[16,1334,1337],{"href":1335,"rel":1336},"https://twitter.com/igrigorik",[],"Ilya Grigorik"," on HTTPS where you can learn more\nabout it.",[12,1340,1341,1342,1347],{},"If you want to check the status of your HTTPS enabled website,\n",[16,1343,1346],{"href":1344,"rel":1345},"https://www.ssllabs.com/ssltest/",[],"SSL Labs offers a free online service"," that\n\"performs a deep analysis of the configuration of any SSL web server on the\npublic Internet\".",[12,1349,1350,1351,21],{},"This article is based on ",[16,1352,1355],{"href":1353,"rel":1354},"https://www.paulwakeford.info/2015/11/24/letsencrypt/",[],"Paul Wakeford's post",[12,1357,1358],{},"I hope it helps you :)",[1360,1361,1362],"style",{},"html pre.shiki code .s7eDp, html code.shiki .s7eDp{--shiki-default:#6F42C1}html pre.shiki code .sYBdl, html code.shiki .sYBdl{--shiki-default:#032F62}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sYu0t, html code.shiki .sYu0t{--shiki-default:#005CC5}html pre.shiki code .shJU0, html code.shiki .shJU0{--shiki-default:#22863A}html pre.shiki code .sgsFI, html code.shiki .sgsFI{--shiki-default:#24292E}html pre.shiki code .sAwPA, html code.shiki .sAwPA{--shiki-default:#6A737D}html pre.shiki code .sD7c4, html code.shiki .sD7c4{--shiki-default:#D73A49}",{"title":151,"searchDepth":175,"depth":175,"links":1364},[1365,1366,1367,1368,1369,1370,1375],{"id":25,"depth":175,"text":26},{"id":81,"depth":175,"text":82},{"id":101,"depth":175,"text":102},{"id":126,"depth":175,"text":127},{"id":423,"depth":175,"text":424},{"id":1027,"depth":175,"text":1028,"children":1371},[1372,1373,1374],{"id":1039,"depth":195,"text":1040},{"id":1087,"depth":195,"text":1088},{"id":1155,"depth":195,"text":1156},{"id":1289,"depth":175,"text":1290},"engineering","2016-04-11","In this post we will talk about HTTPS and how to add it to your GitLab Pages site with Let's Encrypt","md",null,false,"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749672214/Blog/Hero%20Images/altssh.jpg",{"excerpt":1384},{"type":9,"value":1385},[1386],[12,1387,14,1388,21],{},[16,1389,20],{"href":18,"rel":1390},[],"/en-us/blog/tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt",{"title":5,"description":1378,"ogTitle":5,"ogDescription":1378,"noIndex":1381,"ogImage":1382,"ogUrl":1393,"ogSiteName":1394,"ogType":1395,"canonicalUrls":1393},"https://about.gitlab.com/blog/tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt","https://about.gitlab.com","article","tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt","en-us/blog/tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt","BlogPost","c_CgscF5u5UDB0jpZbufKEz6sZT-egfBiUVF7WA3wAc",{"logo":1401,"freeTrial":1405,"sales":1410,"login":1415,"items":1420,"search":1746,"minimal":1777,"duo":1796,"switchNav":1805,"pricingDeployment":1816},{"config":1402},{"href":1246,"dataGaName":1403,"dataGaLocation":1404},"gitlab logo","header",{"text":1406,"config":1407},"Get free trial",{"href":1408,"dataGaName":1409,"dataGaLocation":1404},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com&glm_content=default-saas-trial/","free trial",{"text":1411,"config":1412},"Request a demo",{"href":1413,"dataGaName":1414,"dataGaLocation":1404},"/sales/?contact-topic=request-demo","sales",{"text":1416,"config":1417},"Sign in",{"href":1418,"dataGaName":1419,"dataGaLocation":1404},"https://gitlab.com/users/sign_in/","sign in",[1421,1450,1550,1555,1669,1724],{"text":1422,"config":1423,"menu":1425},"Platform",{"dataNavLevelOne":1424},"platform",{"type":1426,"columns":1427},"cards",[1428,1434,1442],{"title":1422,"description":1429,"link":1430},"The intelligent orchestration platform for DevSecOps",{"text":1431,"config":1432},"Explore our Platform",{"href":1433,"dataGaName":1424,"dataGaLocation":1404},"/platform/",{"title":1435,"description":1436,"link":1437},"GitLab Duo Agent Platform","Agentic AI for the entire software lifecycle",{"text":1438,"config":1439},"Meet GitLab Duo",{"href":1440,"dataGaName":1441,"dataGaLocation":1404},"/gitlab-duo-agent-platform/","gitlab duo agent platform",{"title":1443,"description":1444,"link":1445},"Why GitLab","See the top reasons enterprises choose GitLab",{"text":1446,"config":1447},"Learn more",{"href":1448,"dataGaName":1449,"dataGaLocation":1404},"/why-gitlab/","why gitlab",{"text":1451,"left":673,"config":1452,"menu":1454},"Product",{"dataNavLevelOne":1453},"solutions",{"type":1455,"link":1456,"columns":1460,"feature":1529},"lists",{"text":1457,"config":1458},"View all Solutions",{"href":1459,"dataGaName":1453,"dataGaLocation":1404},"/solutions/",[1461,1485,1508],{"title":1462,"description":1463,"link":1464,"items":1469},"Automation","CI/CD and automation to accelerate deployment",{"config":1465},{"icon":1466,"href":1467,"dataGaName":1468,"dataGaLocation":1404},"AutomatedCodeAlt","/solutions/delivery-automation/","automated software delivery",[1470,1474,1477,1481],{"text":1471,"config":1472},"CI/CD",{"href":1473,"dataGaLocation":1404,"dataGaName":1471},"/solutions/continuous-integration/",{"text":1435,"config":1475},{"href":1440,"dataGaLocation":1404,"dataGaName":1476},"gitlab duo agent platform - product menu",{"text":1478,"config":1479},"Source Code Management",{"href":1480,"dataGaLocation":1404,"dataGaName":1478},"/solutions/source-code-management/",{"text":1482,"config":1483},"Automated Software Delivery",{"href":1467,"dataGaLocation":1404,"dataGaName":1484},"Automated software delivery",{"title":1486,"description":1487,"link":1488,"items":1493},"Security","Deliver code faster without compromising security",{"config":1489},{"href":1490,"dataGaName":1491,"dataGaLocation":1404,"icon":1492},"/solutions/application-security-testing/","security and compliance","ShieldCheckLight",[1494,1498,1503],{"text":1495,"config":1496},"Application Security Testing",{"href":1490,"dataGaName":1497,"dataGaLocation":1404},"Application security testing",{"text":1499,"config":1500},"Software Supply Chain Security",{"href":1501,"dataGaLocation":1404,"dataGaName":1502},"/solutions/supply-chain/","Software supply chain security",{"text":1504,"config":1505},"Software Compliance",{"href":1506,"dataGaName":1507,"dataGaLocation":1404},"/solutions/software-compliance/","software compliance",{"title":1509,"link":1510,"items":1515},"Measurement",{"config":1511},{"icon":1512,"href":1513,"dataGaName":1514,"dataGaLocation":1404},"DigitalTransformation","/solutions/visibility-measurement/","visibility and measurement",[1516,1520,1524],{"text":1517,"config":1518},"Visibility & Measurement",{"href":1513,"dataGaLocation":1404,"dataGaName":1519},"Visibility and Measurement",{"text":1521,"config":1522},"Value Stream Management",{"href":1523,"dataGaLocation":1404,"dataGaName":1521},"/solutions/value-stream-management/",{"text":1525,"config":1526},"Analytics & Insights",{"href":1527,"dataGaLocation":1404,"dataGaName":1528},"/solutions/analytics-and-insights/","Analytics and insights",{"title":1530,"type":1455,"items":1531},"GitLab for",[1532,1538,1544],{"text":1533,"config":1534},"Enterprise",{"icon":1535,"href":1536,"dataGaLocation":1404,"dataGaName":1537},"Building","/enterprise/","enterprise",{"text":1539,"config":1540},"Small Business",{"icon":1541,"href":1542,"dataGaLocation":1404,"dataGaName":1543},"Work","/small-business/","small business",{"text":1545,"config":1546},"Public Sector",{"icon":1547,"href":1548,"dataGaLocation":1404,"dataGaName":1549},"Organization","/solutions/public-sector/","public sector",{"text":1551,"config":1552},"Pricing",{"href":1553,"dataGaName":1554,"dataGaLocation":1404,"dataNavLevelOne":1554},"/pricing/","pricing",{"text":1556,"config":1557,"menu":1559},"Resources",{"dataNavLevelOne":1558},"resources",{"type":1455,"link":1560,"columns":1564,"feature":1658},{"text":1561,"config":1562},"View all resources",{"href":1563,"dataGaName":1558,"dataGaLocation":1404},"/resources/",[1565,1598,1625],{"title":1566,"items":1567},"Getting started",[1568,1573,1578,1583,1588,1593],{"text":1569,"config":1570},"Install",{"href":1571,"dataGaName":1572,"dataGaLocation":1404},"/install/","install",{"text":1574,"config":1575},"Quick start guides",{"href":1576,"dataGaName":1577,"dataGaLocation":1404},"/get-started/","quick setup checklists",{"text":1579,"config":1580},"Learn",{"href":1581,"dataGaLocation":1404,"dataGaName":1582},"https://university.gitlab.com/","learn",{"text":1584,"config":1585},"Product documentation",{"href":1586,"dataGaName":1587,"dataGaLocation":1404},"https://docs.gitlab.com/","product documentation",{"text":1589,"config":1590},"Best practice videos",{"href":1591,"dataGaName":1592,"dataGaLocation":1404},"/getting-started-videos/","best practice videos",{"text":1594,"config":1595},"Integrations",{"href":1596,"dataGaName":1597,"dataGaLocation":1404},"/integrations/","integrations",{"title":1599,"items":1600},"Discover",[1601,1606,1611,1616,1620],{"text":1602,"config":1603},"Customer success stories",{"href":1604,"dataGaName":1605,"dataGaLocation":1404},"/customers/","customer success stories",{"text":1607,"config":1608},"Blog",{"href":1609,"dataGaName":1610,"dataGaLocation":1404},"/blog/","blog",{"text":1612,"config":1613},"Demo Hub",{"href":1614,"dataGaName":1615,"dataGaLocation":1404},"/demo-hub/","demo hub",{"text":1617,"config":1618},"The Source",{"href":1619,"dataGaName":1610,"dataGaLocation":1404},"/the-source/",{"text":1621,"config":1622},"Remote",{"href":1623,"dataGaName":1624,"dataGaLocation":1404},"https://handbook.gitlab.com/handbook/company/culture/all-remote/","remote",{"title":1626,"items":1627},"Connect",[1628,1633,1638,1643,1648,1653],{"text":1629,"config":1630},"GitLab Services",{"href":1631,"dataGaName":1632,"dataGaLocation":1404},"/services/","services",{"text":1634,"config":1635},"Contribute",{"href":1636,"dataGaName":1637,"dataGaLocation":1404},"https://contributors.gitlab.com","contribute",{"text":1639,"config":1640},"Community",{"href":1641,"dataGaName":1642,"dataGaLocation":1404},"/community/","community",{"text":1644,"config":1645},"Forum",{"href":1646,"dataGaName":1647,"dataGaLocation":1404},"https://forum.gitlab.com/","forum",{"text":1649,"config":1650},"Events",{"href":1651,"dataGaName":1652,"dataGaLocation":1404},"/events/","events",{"text":1654,"config":1655},"Partners",{"href":1656,"dataGaName":1657,"dataGaLocation":1404},"/partners/","partners",{"config":1659,"title":1662,"text":1663,"link":1664},{"background":1660,"textColor":1661},"url('https://res.cloudinary.com/about-gitlab-com/image/upload/v1777322348/qpq8yrgn8knii57omj0c.png')","#000","What’s new in GitLab","Stay updated with our latest features and improvements.",{"text":1665,"config":1666},"Read the latest",{"href":1667,"dataGaName":1668,"dataGaLocation":1404},"/whats-new/","whats new",{"text":1670,"config":1671,"menu":1673},"Company",{"dataNavLevelOne":1672},"company",{"type":1455,"columns":1674},[1675],{"items":1676},[1677,1682,1688,1690,1695,1700,1705,1710,1715,1720],{"text":1678,"config":1679},"About",{"href":1680,"dataGaName":1681,"dataGaLocation":1404},"/company/","about",{"text":1683,"config":1684,"footerGa":1687},"Jobs",{"href":1685,"dataGaName":1686,"dataGaLocation":1404},"/jobs/","jobs",{"dataGaName":1686},{"text":1649,"config":1689},{"href":1651,"dataGaName":1652,"dataGaLocation":1404},{"text":1691,"config":1692},"Leadership",{"href":1693,"dataGaName":1694,"dataGaLocation":1404},"/company/team/e-group/","leadership",{"text":1696,"config":1697},"Handbook",{"href":1698,"dataGaName":1699,"dataGaLocation":1404},"https://handbook.gitlab.com/","handbook",{"text":1701,"config":1702},"Investor relations",{"href":1703,"dataGaName":1704,"dataGaLocation":1404},"https://ir.gitlab.com/overview/default.aspx","investor relations",{"text":1706,"config":1707},"Trust Center",{"href":1708,"dataGaName":1709,"dataGaLocation":1404},"/security/","trust center",{"text":1711,"config":1712},"AI Transparency Center",{"href":1713,"dataGaName":1714,"dataGaLocation":1404},"/ai-transparency-center/","ai transparency center",{"text":1716,"config":1717},"Newsletter",{"href":1718,"dataGaName":1719,"dataGaLocation":1404},"/company/contact/#contact-forms","newsletter",{"text":705,"config":1721},{"href":1722,"dataGaName":1723,"dataGaLocation":1404},"/press/","press",{"text":1725,"config":1726,"menu":1727},"Contact us",{"dataNavLevelOne":1672},{"type":1455,"columns":1728},[1729],{"items":1730},[1731,1736,1741],{"text":1732,"config":1733},"Talk to sales",{"href":1734,"dataGaName":1735,"dataGaLocation":1404},"/sales/","talk to sales",{"text":1737,"config":1738},"Support portal",{"href":1739,"dataGaName":1740,"dataGaLocation":1404},"https://support.gitlab.com/hc/en-us","support portal",{"text":1742,"config":1743},"Customer portal",{"href":1744,"dataGaName":1745,"dataGaLocation":1404},"https://customers.gitlab.com/customers/sign_in/","customer portal",{"close":1747,"login":1748,"suggestions":1755},"Close",{"text":1749,"link":1750},"To search repositories and projects, login to",{"text":1751,"config":1752},"gitlab.com",{"href":1418,"dataGaName":1753,"dataGaLocation":1754},"search login","search",{"text":1756,"default":1757},"Suggestions",[1758,1760,1764,1766,1770,1774],{"text":1435,"config":1759},{"href":1440,"dataGaName":1435,"dataGaLocation":1754},{"text":1761,"config":1762},"Code Suggestions (AI)",{"href":1763,"dataGaName":1761,"dataGaLocation":1754},"/solutions/code-suggestions/",{"text":1471,"config":1765},{"href":1473,"dataGaName":1471,"dataGaLocation":1754},{"text":1767,"config":1768},"GitLab on AWS",{"href":1769,"dataGaName":1767,"dataGaLocation":1754},"/partners/technology-partners/aws/",{"text":1771,"config":1772},"GitLab on Google Cloud",{"href":1773,"dataGaName":1771,"dataGaLocation":1754},"/partners/technology-partners/google-cloud-platform/",{"text":1775,"config":1776},"Why GitLab?",{"href":1448,"dataGaName":1775,"dataGaLocation":1754},{"freeTrial":1778,"mobileIcon":1783,"desktopIcon":1788,"secondaryButton":1791},{"text":1779,"config":1780},"Start free trial",{"href":1781,"dataGaName":1409,"dataGaLocation":1782},"https://gitlab.com/-/trials/new/","nav",{"altText":1784,"config":1785},"Gitlab Icon",{"src":1786,"dataGaName":1787,"dataGaLocation":1782},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203874/jypbw1jx72aexsoohd7x.svg","gitlab icon",{"altText":1784,"config":1789},{"src":1790,"dataGaName":1787,"dataGaLocation":1782},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203875/gs4c8p8opsgvflgkswz9.svg",{"text":1792,"config":1793},"Get Started",{"href":1794,"dataGaName":1795,"dataGaLocation":1782},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com/get-started/","get started",{"freeTrial":1797,"mobileIcon":1801,"desktopIcon":1803},{"text":1798,"config":1799},"Learn more about GitLab Duo",{"href":1440,"dataGaName":1800,"dataGaLocation":1782},"gitlab duo",{"altText":1784,"config":1802},{"src":1786,"dataGaName":1787,"dataGaLocation":1782},{"altText":1784,"config":1804},{"src":1790,"dataGaName":1787,"dataGaLocation":1782},{"button":1806,"mobileIcon":1811,"desktopIcon":1813},{"text":1807,"config":1808},"/switch",{"href":1809,"dataGaName":1810,"dataGaLocation":1782},"#contact","switch",{"altText":1784,"config":1812},{"src":1786,"dataGaName":1787,"dataGaLocation":1782},{"altText":1784,"config":1814},{"src":1815,"dataGaName":1787,"dataGaLocation":1782},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1773335277/ohhpiuoxoldryzrnhfrh.png",{"freeTrial":1817,"mobileIcon":1822,"desktopIcon":1824},{"text":1818,"config":1819},"Back to pricing",{"href":1553,"dataGaName":1820,"dataGaLocation":1782,"icon":1821},"back to pricing","GoBack",{"altText":1784,"config":1823},{"src":1786,"dataGaName":1787,"dataGaLocation":1782},{"altText":1784,"config":1825},{"src":1790,"dataGaName":1787,"dataGaLocation":1782},{"title":1827,"titleMobile":1828,"button":1829,"config":1834},"Duo Agent Platform delivers 400% ROI, per new Forrester Consulting study.","400% ROI: Forrester TEI for GitLab Duo",{"text":1446,"config":1830},{"href":1831,"dataGaName":1832,"dataGaLocation":1833},"https://about.gitlab.com/blog/gitlab-duo-agent-platform-delivers-400-percent-roi/","forrester-tei-dap-banner","global-banner",{"layout":1835,"disabled":1381},"release",{"data":1837},{"text":1838,"source":1839,"edit":1845,"contribute":1850,"config":1855,"items":1860,"minimal":2070},"Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license",{"text":1840,"config":1841},"View page source",{"href":1842,"dataGaName":1843,"dataGaLocation":1844},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/","page source","footer",{"text":1846,"config":1847},"Edit this page",{"href":1848,"dataGaName":1849,"dataGaLocation":1844},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/-/blob/main/content/","web ide",{"text":1851,"config":1852},"Please contribute",{"href":1853,"dataGaName":1854,"dataGaLocation":1844},"https://gitlab.com/gitlab-com/marketing/digital-experience/about-gitlab-com/-/blob/main/CONTRIBUTING.md/","please contribute",{"twitter":1856,"facebook":1857,"youtube":1858,"linkedin":1859},"https://twitter.com/gitlab","https://www.facebook.com/gitlab","https://www.youtube.com/channel/UCnMGQ8QHMAnVIsI3xJrihhg","https://www.linkedin.com/company/gitlab-com",[1861,1908,1962,2006,2038],{"title":1551,"links":1862,"subMenu":1877},[1863,1867,1872],{"text":1864,"config":1865},"View plans",{"href":1553,"dataGaName":1866,"dataGaLocation":1844},"view plans",{"text":1868,"config":1869},"Why Premium?",{"href":1870,"dataGaName":1871,"dataGaLocation":1844},"/pricing/premium/","why premium",{"text":1873,"config":1874},"Why Ultimate?",{"href":1875,"dataGaName":1876,"dataGaLocation":1844},"/pricing/ultimate/","why ultimate",[1878],{"title":1879,"links":1880},"Contact Us",[1881,1884,1886,1888,1893,1898,1903],{"text":1882,"config":1883},"Contact sales",{"href":1734,"dataGaName":1414,"dataGaLocation":1844},{"text":1737,"config":1885},{"href":1739,"dataGaName":1740,"dataGaLocation":1844},{"text":1742,"config":1887},{"href":1744,"dataGaName":1745,"dataGaLocation":1844},{"text":1889,"config":1890},"Status",{"href":1891,"dataGaName":1892,"dataGaLocation":1844},"https://status.gitlab.com/","status",{"text":1894,"config":1895},"Terms of use",{"href":1896,"dataGaName":1897,"dataGaLocation":1844},"/terms/","terms of use",{"text":1899,"config":1900},"Privacy statement",{"href":1901,"dataGaName":1902,"dataGaLocation":1844},"/privacy/","privacy statement",{"text":1904,"config":1905},"Cookie preferences",{"dataGaName":1906,"dataGaLocation":1844,"id":1907,"isOneTrustButton":673},"cookie preferences","ot-sdk-btn",{"title":1451,"links":1909,"subMenu":1918},[1910,1914],{"text":1911,"config":1912},"DevSecOps platform",{"href":1433,"dataGaName":1913,"dataGaLocation":1844},"devsecops platform",{"text":1915,"config":1916},"AI-Assisted Development",{"href":1440,"dataGaName":1917,"dataGaLocation":1844},"ai-assisted development",[1919],{"title":1920,"links":1921},"Topics",[1922,1927,1932,1937,1942,1947,1952,1957],{"text":1923,"config":1924},"CICD",{"href":1925,"dataGaName":1926,"dataGaLocation":1844},"/topics/ci-cd/","cicd",{"text":1928,"config":1929},"GitOps",{"href":1930,"dataGaName":1931,"dataGaLocation":1844},"/topics/gitops/","gitops",{"text":1933,"config":1934},"DevOps",{"href":1935,"dataGaName":1936,"dataGaLocation":1844},"/topics/devops/","devops",{"text":1938,"config":1939},"Version Control",{"href":1940,"dataGaName":1941,"dataGaLocation":1844},"/topics/version-control/","version control",{"text":1943,"config":1944},"DevSecOps",{"href":1945,"dataGaName":1946,"dataGaLocation":1844},"/topics/devsecops/","devsecops",{"text":1948,"config":1949},"Cloud Native",{"href":1950,"dataGaName":1951,"dataGaLocation":1844},"/topics/cloud-native/","cloud native",{"text":1953,"config":1954},"AI for Coding",{"href":1955,"dataGaName":1956,"dataGaLocation":1844},"/topics/devops/ai-for-coding/","ai for coding",{"text":1958,"config":1959},"Agentic AI",{"href":1960,"dataGaName":1961,"dataGaLocation":1844},"/topics/agentic-ai/","agentic ai",{"title":1963,"links":1964},"Solutions",[1965,1967,1969,1974,1978,1981,1985,1988,1990,1993,1996,2001],{"text":1495,"config":1966},{"href":1490,"dataGaName":1495,"dataGaLocation":1844},{"text":1484,"config":1968},{"href":1467,"dataGaName":1468,"dataGaLocation":1844},{"text":1970,"config":1971},"Agile development",{"href":1972,"dataGaName":1973,"dataGaLocation":1844},"/solutions/agile-delivery/","agile delivery",{"text":1975,"config":1976},"SCM",{"href":1480,"dataGaName":1977,"dataGaLocation":1844},"source code management",{"text":1923,"config":1979},{"href":1473,"dataGaName":1980,"dataGaLocation":1844},"continuous integration & delivery",{"text":1982,"config":1983},"Value stream management",{"href":1523,"dataGaName":1984,"dataGaLocation":1844},"value stream management",{"text":1928,"config":1986},{"href":1987,"dataGaName":1931,"dataGaLocation":1844},"/solutions/gitops/",{"text":1533,"config":1989},{"href":1536,"dataGaName":1537,"dataGaLocation":1844},{"text":1991,"config":1992},"Small business",{"href":1542,"dataGaName":1543,"dataGaLocation":1844},{"text":1994,"config":1995},"Public sector",{"href":1548,"dataGaName":1549,"dataGaLocation":1844},{"text":1997,"config":1998},"Education",{"href":1999,"dataGaName":2000,"dataGaLocation":1844},"/solutions/education/","education",{"text":2002,"config":2003},"Financial services",{"href":2004,"dataGaName":2005,"dataGaLocation":1844},"/solutions/finance/","financial services",{"title":1556,"links":2007},[2008,2010,2012,2014,2017,2019,2022,2024,2026,2028,2030,2032,2034,2036],{"text":1569,"config":2009},{"href":1571,"dataGaName":1572,"dataGaLocation":1844},{"text":1574,"config":2011},{"href":1576,"dataGaName":1577,"dataGaLocation":1844},{"text":1579,"config":2013},{"href":1581,"dataGaName":1582,"dataGaLocation":1844},{"text":1584,"config":2015},{"href":1586,"dataGaName":2016,"dataGaLocation":1844},"docs",{"text":1607,"config":2018},{"href":1609,"dataGaName":1610,"dataGaLocation":1844},{"text":2020,"config":2021},"What's new",{"href":1667,"dataGaName":1668,"dataGaLocation":1844},{"text":1602,"config":2023},{"href":1604,"dataGaName":1605,"dataGaLocation":1844},{"text":1621,"config":2025},{"href":1623,"dataGaName":1624,"dataGaLocation":1844},{"text":1629,"config":2027},{"href":1631,"dataGaName":1632,"dataGaLocation":1844},{"text":1634,"config":2029},{"href":1636,"dataGaName":1637,"dataGaLocation":1844},{"text":1639,"config":2031},{"href":1641,"dataGaName":1642,"dataGaLocation":1844},{"text":1644,"config":2033},{"href":1646,"dataGaName":1647,"dataGaLocation":1844},{"text":1649,"config":2035},{"href":1651,"dataGaName":1652,"dataGaLocation":1844},{"text":1654,"config":2037},{"href":1656,"dataGaName":1657,"dataGaLocation":1844},{"title":1670,"links":2039},[2040,2042,2044,2046,2048,2050,2054,2059,2061,2063,2065],{"text":1678,"config":2041},{"href":1680,"dataGaName":1672,"dataGaLocation":1844},{"text":1683,"config":2043},{"href":1685,"dataGaName":1686,"dataGaLocation":1844},{"text":1691,"config":2045},{"href":1693,"dataGaName":1694,"dataGaLocation":1844},{"text":1696,"config":2047},{"href":1698,"dataGaName":1699,"dataGaLocation":1844},{"text":1701,"config":2049},{"href":1703,"dataGaName":1704,"dataGaLocation":1844},{"text":2051,"config":2052},"Sustainability",{"href":2053,"dataGaName":2051,"dataGaLocation":1844},"/sustainability/",{"text":2055,"config":2056},"Diversity, inclusion and belonging (DIB)",{"href":2057,"dataGaName":2058,"dataGaLocation":1844},"/diversity-inclusion-belonging/","Diversity, inclusion and belonging",{"text":1706,"config":2060},{"href":1708,"dataGaName":1709,"dataGaLocation":1844},{"text":1716,"config":2062},{"href":1718,"dataGaName":1719,"dataGaLocation":1844},{"text":705,"config":2064},{"href":1722,"dataGaName":1723,"dataGaLocation":1844},{"text":2066,"config":2067},"Modern Slavery Transparency Statement",{"href":2068,"dataGaName":2069,"dataGaLocation":1844},"https://handbook.gitlab.com/handbook/legal/modern-slavery-act-transparency-statement/","modern slavery transparency statement",{"items":2071},[2072,2075,2078],{"text":2073,"config":2074},"Terms",{"href":1896,"dataGaName":1897,"dataGaLocation":1844},{"text":2076,"config":2077},"Cookies",{"dataGaName":1906,"dataGaLocation":1844,"id":1907,"isOneTrustButton":673},{"text":2079,"config":2080},"Privacy",{"href":1901,"dataGaName":1902,"dataGaLocation":1844},[2082],{"id":2083,"title":2084,"body":1380,"config":2085,"content":2087,"description":1380,"extension":2091,"meta":2092,"navigation":673,"path":2093,"seo":2094,"stem":2095,"__hash__":2096},"blogAuthors/en-us/blog/authors/guest-author-andr-miranda.yml","Guest Author Andr Miranda",{"template":2086},"BlogAuthor",{"name":7,"config":2088},{"headshot":2089,"ctfId":2090},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749659488/Blog/Author%20Headshots/gitlab-logo-extra-whitespace.png","Guest-author-Andr-Miranda","yml",{},"/en-us/blog/authors/guest-author-andr-miranda",{},"en-us/blog/authors/guest-author-andr-miranda","ac2zHo3Yd7Rcc4McAovjjDoyFOUP1di-YhL9MOAJMAk",[2098,2107,2115],{"title":2099,"description":2100,"heroImage":2101,"category":1376,"date":2102,"authors":2103,"slug":2106,"externalUrl":1380},"Confidential AI for GitLab Self-Hosted","Give developers AI coding agents in GitLab Duo without source code leaving a hardware-encrypted boundary — no GPUs needed.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1773866173/vte9qh8rriznvyclhkes.png","2026-08-06",[2104,2105],"Mathias Ewald","Martin Paloncy, Edgeless Systems","confidential-ai-for-gitlab-self-hosted",{"title":2108,"description":2109,"heroImage":2110,"category":1376,"date":2111,"authors":2112,"slug":2114,"externalUrl":1380},"Green DevOps: Why carbon measurement belongs in your CI/CD pipeline","CI/CD pipelines have a hidden carbon cost. Here's why measuring it matters, and how you can get started with Eco CI and Carmen in GitLab.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1765809212/noh0mdfn9o94ry9ykura.png","2026-07-09",[2113],"Lysanne Pinto","green-devops-carbon-measurement-cicd-pipeline",{"title":2116,"description":2117,"heroImage":2118,"category":1376,"date":2119,"authors":2120,"slug":2122,"externalUrl":1380},"How to build CI/CD observability at scale","This practical guide to GitLab pipeline analytics helps self-managed users gain operational insights using Prometheus and Grafana.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1774465167/n5hlvrsrheadeccyr1oz.png","2026-04-28",[2121],"Paul Meresanu","how-to-build-ci-cd-observability-at-scale",{"promotions":2124},[2125,2139,2151,2163],{"id":2126,"categories":2127,"header":2129,"text":2130,"button":2131,"image":2136},"ai-modernization",[2128],"ai","Is AI achieving its promise at scale?","Quiz will take 5 minutes or less",{"text":2132,"config":2133},"Get your AI maturity score",{"href":2134,"dataGaName":2135,"dataGaLocation":1610},"/assessments/ai-modernization-assessment/","modernization assessment",{"config":2137},{"src":2138},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1772138786/qix0m7kwnd8x2fh1zq49.png",{"id":2140,"categories":2141,"header":2143,"text":2130,"button":2144,"image":2148},"devops-modernization",[2142,1946],"product","Are you just managing tools or shipping innovation?",{"text":2145,"config":2146},"Get your DevOps maturity score",{"href":2147,"dataGaName":2135,"dataGaLocation":1610},"/assessments/devops-modernization-assessment/",{"config":2149},{"src":2150},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1772138785/eg818fmakweyuznttgid.png",{"id":2152,"categories":2153,"header":2155,"text":2130,"button":2156,"image":2160},"security-modernization",[2154],"security","Are you trading speed for security?",{"text":2157,"config":2158},"Get your security maturity score",{"href":2159,"dataGaName":2135,"dataGaLocation":1610},"/assessments/security-modernization-assessment/",{"config":2161},{"src":2162},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1772138786/p4pbqd9nnjejg5ds6mdk.png",{"id":2164,"paths":2165,"header":2168,"text":2169,"button":2170,"image":2175},"github-azure-migration",[2166,2167],"migration-from-azure-devops-to-gitlab","integrating-azure-devops-scm-and-gitlab","Is your team ready for GitHub's Azure move?","GitHub is already rebuilding around Azure. Find out what it means for you.",{"text":2171,"config":2172},"See how GitLab compares to GitHub",{"href":2173,"dataGaName":2174,"dataGaLocation":1610},"/compare/gitlab-vs-github/github-azure-migration/","github azure migration",{"config":2176},{"src":2150},{"header":2178,"blurb":2179,"button":2180,"secondaryButton":2185},"Start building faster today","See what your team can do with the intelligent orchestration platform for DevSecOps.\n",{"text":2181,"config":2182},"Get your free trial",{"href":2183,"dataGaName":1409,"dataGaLocation":2184},"https://gitlab.com/-/trial_registrations/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/","feature",{"text":1882,"config":2186},{"href":1734,"dataGaName":1414,"dataGaLocation":2184},1786803766592]