[{"data":1,"prerenderedAt":2390},["ShallowReactive",2],{"/blog/gitlab-pages-setup":3,"navigation-en-us":1642,"banner-en-us":2077,"footer-en-us":2085,"blog-post-authors-en-us-Marcia Ramos":2330,"blog-related-posts-en-us-gitlab-pages-setup":2345,"blog-share-wrapper-en-us":2370,"next-steps-en-us":2380},{"id":4,"title":5,"authors":6,"body":8,"category":1588,"date":1589,"description":1590,"extension":1591,"externalUrl":1592,"faq":1592,"featured":1593,"heroImage":1594,"hidePromo":1593,"meta":1595,"navigation":714,"path":1633,"seo":1634,"slug":1638,"stem":1639,"tags":1592,"template":1640,"updatedDate":1592,"__hash__":1641},"blogPosts/en-us/blog/gitlab-pages-setup.md","Hosting on GitLab.com with GitLab Pages",[7],"Marcia Ramos",{"type":9,"value":10,"toc":1564},"minimark",[11,29,32,70,79,82,87,94,96,101,104,115,118,130,159,163,166,175,182,186,199,211,221,225,240,266,284,306,319,336,343,353,357,360,383,387,396,400,403,447,457,463,466,470,482,590,648,651,655,667,674,686,695,772,808,841,845,861,867,977,1019,1044,1048,1051,1079,1085,1093,1106,1110,1120,1129,1137,1142,1190,1195,1240,1246,1258,1264,1286,1292,1295,1304,1307,1310,1317,1348,1353,1357,1362,1384,1389,1392,1397,1400,1408,1415,1421,1429,1435,1440,1453,1458,1470,1475,1478,1486,1492,1496,1509,1514,1518,1527,1536,1539,1544,1548,1560],[12,13,14,15,21,22,28],"p",{},"In this article we provide you with detailed information about using ",[16,17,20],"a",{"href":18,"rel":19},"https://pages.gitlab.io",[],"GitLab Pages"," to\nhost your website for free on ",[16,23,27],{"href":24,"rel":25,"title":26},"https://gitlab.com/users/sign_in",[],"Sign Up, it's free!","GitLab.com",".",[12,30,31],{},"We've prepared a step-by-step tutorial on creating a new project for GitLab Pages so you won't get lost in the process.",[12,33,34,35,40,41,45,46,51,52,56,57,56,60,56,63,66,67,28],{},"GitLab Pages supports ",[16,36,39],{"href":37,"rel":38},"https://en.wikipedia.org/wiki/Static_web_page",[],"static websites"," and builds ",[42,43,44],"strong",{},"any"," ",[16,47,50],{"href":48,"rel":49},"https://www.staticgen.com/",[],"Static Site Generator (SSG)",",\nsuch as ",[53,54,55],"span",{},"Jekyll",", ",[53,58,59],{},"Hugo",[53,61,62],{},"Hexo",[53,64,65],{},"Middleman"," and ",[53,68,69],{},"Pelican",[12,71,72,73,78],{},"We are assuming that you are familiar with ",[16,74,77],{"href":75,"rel":76},"https://git-scm.com/about",[],"Git"," and with the web development process, from creation to publishing.",[80,81],"hr",{},[83,84,86],"h3",{"id":85},"whats-in-this-tutorial","What's in this tutorial?",[88,89,90],"ul",{},[91,92,93],"li",{},"TOC",[80,95],{},[97,98,100],"h2",{"id":99},"getting-started","Getting Started",[12,102,103],{},"There are two ways of getting started with GitLab Pages: either you fork an existing project, or you create a new one for yourself.",[12,105,106,107,111,112,114],{},"On the ",[16,108,110],{"href":18,"rel":109},[],"GitLab Pages Quick Start Guide",", which is, by the way, a site built with ",[53,113,65],{},",\nyou will find the steps for forking an existing project from a list of examples prepared for you.\nThere are some popular SSGs, like Jekyll, Hugo, Hexo, Brunch, etc.",[12,116,117],{},"However, if you want to understand the process of creating a new project from scratch, this post is for you.",[12,119,120,121,125,126,129],{},"On the official documentation you can learn about ",[16,122,20],{"href":123,"rel":124},"https://docs.gitlab.com/pages/README/#getting-started-with-gitlab-pages",[],", but here we will focus on the ",[42,127,128],{},"steps","\nfor creating your own project.",[12,131,132,45,135,139,140,66,143,147,148,153,154,158],{},[42,133,134],{},"Note:",[16,136,138],{"href":137},"/blog/gitlab-pages-get-started/","GitLab Pages was introduced in GitLab EE 8.3",".\nIt is available for ",[16,141,27],{"href":24,"rel":142,"title":26},[],[16,144,146],{"href":145},"/pricing/feature-comparison/","GitLab Enterprise Edition"," users.\nUpdate: ",[16,149,152],{"href":150,"rel":151},"https://docs.gitlab.com/releases/#gitlab-pages-in-community-edition",[],"GitLab 8.17","\nbrought GitLab Pages to ",[16,155,157],{"href":156},"/gitlab-community-edition/","GitLab Community Edition","! Enjoy!",[97,160,162],{"id":161},"website-types","Website Types",[12,164,165],{},"In general, you are allowed to create and host two sorts of websites with GitLab Pages:",[167,168,169,172],"ol",{},[91,170,171],{},"User/Group Websites - a single site per user or group",[91,173,174],{},"Project Websites - as many sites you want",[12,176,177,178,28],{},"You can find out more about them on the ",[16,179,181],{"href":123,"rel":180},[],"docs",[83,183,185],{"id":184},"a-note-regarding-gitlab-groups-and-namespaces","A note regarding GitLab Groups and Namespaces",[12,187,188,189,194,195,198],{},"Creating a ",[16,190,193],{"href":191,"rel":192},"https://docs.gitlab.com/workflow/groups/",[],"group"," on GitLab is very useful when you have several projects with the same subject.\nA group has its own ",[42,196,197],{},"namespace",", which is unique for each group (and for each user).",[12,200,201,202,206,207,210],{},"The important matter is, when you create your account on GitLab, it's better to choose a username for\nyourself as a person, not as a company. You can create your \"company username\" later, as a group\nnamespace. For example, let's say your name is \"John Doe\" and your company is called \"Foo Main\".\nFirst, register yourself as ",[203,204,205],"code",{},"johndoe"," and later create a group called Foo Main within the namespace of\n",[203,208,209],{},"foomain",". This will allow you to separate your personal projects from your company ones.",[12,212,213,214,217,218,28],{},"If you follow this tip, you will be able to access your personal site under ",[203,215,216],{},"https://username.gitlab.io","\nand your company site under ",[203,219,220],{},"https://groupname.gitlab.io",[97,222,224],{"id":223},"about-gitlab-ci-for-gitlab-pages","About GitLab CI for GitLab Pages",[12,226,227,228,236,237,28],{},"The key to having everything up and running as expected is the ",[16,229,232,235],{"href":230,"rel":231},"https://docs.gitlab.com/ci/quick_start/README/#creating-a-.gitlab-ci.yml-file",[],[42,233,234],{},"GitLab CI"," configuration file",", called ",[203,238,239],{},".gitlab-ci.yml",[12,241,242,243,248,249,257,258,261,262,265],{},"This file ",[16,244,247],{"href":245,"rel":246},"https://docs.gitlab.com/ci/yaml/README/",[],"configures"," how your website will be built by a ",[250,251,252],"em",{},[16,253,256],{"href":254,"rel":255},"https://docs.gitlab.com/ci/quick_start/README/#configuring-a-runner",[],"Runner",".\nIt is written in ",[53,259,260],{},"YAML",", which has its own syntax, so we recommend you\nfollow this ",[53,263,264],{},"quick start guide"," before setting it up.\nIt needs to be placed at your root directory.",[12,267,268,269,56,272,275,276,279,280,283],{},"The most important fact is that with ",[16,270,234],{"href":271},"/solutions/continuous-integration/",[42,273,274],{},"you"," take control over your builds.\nThey won't be in an invisible black box where you don't know what is going on!\nYou can actually ",[42,277,278],{},"see"," any build running live by navigating to your project's ",[42,281,282],{},"Pipelines > Builds > Build ID",".\nYou can also add any command to your script. This is far beyond useful as it allows you to do\npretty much anything you do on your local machine!",[12,285,286,287,290,291,294,295,298,299,298,302,305],{},"For example, you can add any ",[53,288,289],{},"Jekyll Plugin"," to your Jekyll site,\nyou can require any ",[203,292,293],{},"gem"," you need in your ",[203,296,297],{},"Gemfile",", run ",[203,300,301],{},"npm",[203,303,304],{},"bundle"," and much more.\nBottom line, it's as handy as having your own command line on your GitLab UI.",[12,307,308,309,311,312,315,316,318],{},"Additionally, you can have a distinct ",[203,310,239],{}," for each repository - even for each branch.\nThis means you can test your script in parallel branches before pushing to your ",[203,313,314],{},"main"," branch.\nIf the build succeeds, you merge. If it doesn't, you can make adjustments and try building\nagain without messing up your ",[203,317,314],{}," branch.",[12,320,321,322,324,325,331,332,335],{},"Before you push any ",[203,323,239],{}," to your project, you can\nvalidate its syntax with the tool called ",[16,326,330],{"href":327,"rel":328,"title":329},"https://gitlab.com/ci/lint",[],"Try me!","CI Lint",".\nYou need to be logged into your account to have access to this tool.\nIt's found by navigating to your project's ",[42,333,334],{},"Pipelines",": there is a button at the top-right of your screen.",[12,337,338],{},[339,340],"img",{"alt":341,"src":342},"CI-Lint","https://res.cloudinary.com/about-gitlab-com/image/upload/v1782398421/blog/Content%20Images/gitlab-pages/gitlab-ci-lint.png",[12,344,345,346,352],{},"You can read through the ",[16,347,349,350],{"href":245,"rel":348},[],"full documentation for ",[203,351,239],{}," for more information.",[97,354,356],{"id":355},"creating-new-gitlab-pages-projects","Creating new GitLab Pages projects",[12,358,359],{},"Here is an overview of the steps we'll take, assuming you already have your GitLab.com account:",[167,361,362,365,371,374,380],{},[91,363,364],{},"Create a new project",[91,366,367,368,370],{},"Add the configuration file (",[203,369,239],{},")",[91,372,373],{},"Upload your website content",[91,375,376,377],{},"Add your custom domain ",[250,378,379],{},"(optional)",[91,381,382],{},"Done!",[97,384,386],{"id":385},"step-by-step","Step-by-step",[12,388,389,390,395],{},"Now we will go through this process step-by-step. Update: watch the video tutorial on\n",[16,391,394],{"href":392,"rel":393},"https://youtu.be/TWqh9MtT4Bg",[],"How to Publish a Website with GitLab Pages on GitLab.com from a forked project","!",[83,397,399],{"id":398},"step-1-create-a-new-project","Step 1: Create a new project",[12,401,402],{},"This is as straight-forward as you can imagine:",[88,404,405,416],{},[91,406,407,408,411,412,415],{},"On your ",[42,409,410],{},"dashboard"," you will see a big green button called ",[42,413,414],{},"+ New Project",". Click on it.",[91,417,418,419],{},"Set the first things up:\n",[88,420,421,430],{},[91,422,423,426,427],{},[42,424,425],{},"Project path"," - your project's name, accessed via ",[203,428,429],{},"https://gitlab.com/namespace/projectname",[91,431,432,435,436,439,440,443,444,370],{},[42,433,434],{},"Privacy"," - choose if you want your project to be visible and accessible just for you (",[203,437,438],{},"private","),\njust for GitLab.com users (",[203,441,442],{},"internal",") or free to anyone to view, clone, fork and download it (",[203,445,446],{},"public",[12,448,449,452,453,456],{},[42,450,451],{},"Note",": you can host your website on ",[16,454,27],{"href":455},"/pricing/"," even if it is stored in a private repository.\nIf you do so, you can have your project protected - only the static site will be visible\nto the public - via \"Inspect Element\" or \"View-Source\" from their web browsers.",[83,458,460,461],{"id":459},"step-2-add-the-configuration-file-gitlab-ciyml","Step 2: Add the configuration file: ",[203,462,239],{},[12,464,465],{},"Now we can have some fun! Let's tell GitLab CI how to build the site.\nYou will see a few examples below (options A, B, and C) to understand how they work.",[83,467,469],{"id":468},"option-a-gitlab-ci-for-plain-html-websites","Option A: GitLab CI for plain HTML websites",[12,471,472,473,478,479,481],{},"In order to build your ",[16,474,477],{"href":475,"rel":476},"https://docs.gitlab.com/pages/README/#how-.gitlab-ci.yml-looks-like-when-the-static-content-is-in-your-repository",[],"plain HTML site"," with GitLab Pages,\nyour ",[203,480,239],{}," file doesn't need much:",[483,484,489],"pre",{"className":485,"code":486,"language":487,"meta":488,"style":488},"language-yaml shiki shiki-themes github-light","pages:\n  stage: deploy\n  script:\n  - mkdir .public\n  - cp -r * .public\n  - mv .public public\n  artifacts:\n    paths:\n    - public\n  only:\n  - main\n\n","yaml","",[203,490,491,503,516,524,533,541,549,557,565,574,582],{"__ignoreMap":488},[53,492,495,499],{"class":493,"line":494},"line",1,[53,496,498],{"class":497},"shJU0","pages",[53,500,502],{"class":501},"sgsFI",":\n",[53,504,506,509,512],{"class":493,"line":505},2,[53,507,508],{"class":497},"  stage",[53,510,511],{"class":501},": ",[53,513,515],{"class":514},"sYBdl","deploy\n",[53,517,519,522],{"class":493,"line":518},3,[53,520,521],{"class":497},"  script",[53,523,502],{"class":501},[53,525,527,530],{"class":493,"line":526},4,[53,528,529],{"class":501},"  - ",[53,531,532],{"class":514},"mkdir .public\n",[53,534,536,538],{"class":493,"line":535},5,[53,537,529],{"class":501},[53,539,540],{"class":514},"cp -r * .public\n",[53,542,544,546],{"class":493,"line":543},6,[53,545,529],{"class":501},[53,547,548],{"class":514},"mv .public public\n",[53,550,552,555],{"class":493,"line":551},7,[53,553,554],{"class":497},"  artifacts",[53,556,502],{"class":501},[53,558,560,563],{"class":493,"line":559},8,[53,561,562],{"class":497},"    paths",[53,564,502],{"class":501},[53,566,568,571],{"class":493,"line":567},9,[53,569,570],{"class":501},"    - ",[53,572,573],{"class":514},"public\n",[53,575,577,580],{"class":493,"line":576},10,[53,578,579],{"class":497},"  only",[53,581,502],{"class":501},[53,583,585,587],{"class":493,"line":584},11,[53,586,529],{"class":501},[53,588,589],{"class":514},"main\n",[12,591,592,593,600,601,607,608,614,615,622,623,630,631,637,638,645,646,318],{},"What this code is doing is creating a ",[250,594,595],{},[16,596,599],{"href":597,"rel":598},"https://docs.gitlab.com/ce/ci/yaml/README/#jobs",[],"job"," called ",[250,602,603],{},[16,604,498],{"href":605,"rel":606},"https://docs.gitlab.com/pages/README/#explore-the-contents-of-.gitlab-ci.yml",[],"\ntelling the ",[250,609,610],{},[16,611,256],{"href":612,"rel":613},"https://docs.gitlab.com/ci/quick_start/README/#shared-runners",[]," to ",[250,616,617],{},[16,618,621],{"href":619,"rel":620},"https://docs.gitlab.com/ce/ci/yaml/README/#stages",[],"deploy"," the website ",[250,624,625],{},[16,626,629],{"href":627,"rel":628},"https://docs.gitlab.com/ci/yaml/README/#artifacts",[],"artifacts","\nto a ",[250,632,633],{},[16,634,636],{"href":605,"rel":635},[],"public path",",\nwhenever a commit is pushed ",[250,639,640],{},[16,641,644],{"href":642,"rel":643},"https://docs.gitlab.com/ci/yaml/README/#only-and-except",[],"only"," to the ",[203,647,314],{},[12,649,650],{},"All pages are created after the build completes successfully\nand the artifacts for the pages job are uploaded to GitLab.",[83,652,654],{"id":653},"option-b-gitlab-ci-for-jekyll-websites","Option B: GitLab CI for Jekyll websites",[12,656,657,658,661,662,666],{},"Jekyll is so far the most popular ",[16,659,50],{"href":48,"rel":660},[]," available, that's why we'll use it as a first example\nfor configuring our GitLab CI. On the next section you'll find more ",[16,663,665],{"href":664},"#examples","examples"," for SSGs already tested with GitLab Pages.",[12,668,669,670,673],{},"Jekyll is written in ",[53,671,672],{},"Ruby"," and generates static blog-aware websites.\nBlog-aware means a website generator will create blog-style content, such as lists of\ncontent in reverse chronological order, archive lists, and\nother common blog-style features.",[12,675,676,677,56,680,66,683,685],{},"We can write dynamically with ",[53,678,679],{},"Liquid",[53,681,682],{},"Markdown",[53,684,260],{}," and\nJekyll builds the static site (HTML, CSS, JS) for us.\nYou will find the same functionality for every SSG,\nyet each of them uses its own environment, template system, markup language, etc.",[12,687,688,689,694],{},"If you want GitLab Pages to ",[16,690,693],{"href":691,"rel":692},"https://docs.gitlab.com/pages/README/#how-.gitlab-ci.yml-looks-like-when-using-a-static-generator",[],"build your Jekyll website",",\nyou can start with the simple script below:",[483,696,698],{"className":485,"code":697,"language":487,"meta":488,"style":488},"image: ruby:2.1\n\npages:\n  script:\n  - gem install jekyll\n  - jekyll build -d public/\n  artifacts:\n    paths:\n    - public\n  only:\n  - main\n\n",[203,699,700,710,716,722,728,735,742,748,754,760,766],{"__ignoreMap":488},[53,701,702,705,707],{"class":493,"line":494},[53,703,704],{"class":497},"image",[53,706,511],{"class":501},[53,708,709],{"class":514},"ruby:2.1\n",[53,711,712],{"class":493,"line":505},[53,713,715],{"emptyLinePlaceholder":714},true,"\n",[53,717,718,720],{"class":493,"line":518},[53,719,498],{"class":497},[53,721,502],{"class":501},[53,723,724,726],{"class":493,"line":526},[53,725,521],{"class":497},[53,727,502],{"class":501},[53,729,730,732],{"class":493,"line":535},[53,731,529],{"class":501},[53,733,734],{"class":514},"gem install jekyll\n",[53,736,737,739],{"class":493,"line":543},[53,738,529],{"class":501},[53,740,741],{"class":514},"jekyll build -d public/\n",[53,743,744,746],{"class":493,"line":551},[53,745,554],{"class":497},[53,747,502],{"class":501},[53,749,750,752],{"class":493,"line":559},[53,751,562],{"class":497},[53,753,502],{"class":501},[53,755,756,758],{"class":493,"line":567},[53,757,570],{"class":501},[53,759,573],{"class":514},[53,761,762,764],{"class":493,"line":576},[53,763,579],{"class":497},[53,765,502],{"class":501},[53,767,768,770],{"class":493,"line":584},[53,769,529],{"class":501},[53,771,589],{"class":514},[12,773,774,775,782,783,790,791,793,794,799,800,805,806,28],{},"This code requires the ",[250,776,777],{},[16,778,781],{"href":779,"rel":780},"https://docs.gitlab.com/ci/yaml/README/#script",[],"script"," to run on\nthe ",[250,784,785],{},[16,786,789],{"href":787,"rel":788},"https://docs.gitlab.com/ci/yaml/README/#image-and-services",[],"environment"," of ",[53,792,672],{}," 2.1.x,\ninstalls the Jekyll gem, and builds the site\nto the ",[250,795,796],{},[16,797,636],{"href":605,"rel":798},[],".\nThe result affects ",[250,801,802],{},[16,803,644],{"href":642,"rel":804},[]," the main branch.\nFor building a regular Jekyll site, you can just\ncopy this code and paste it into your ",[203,807,239],{},[12,809,810,811,814,815,820,821,825,826,831,832,837,838],{},"If you are familiar with Jekyll, you will probably want to use ",[53,812,813],{},"Bundler"," to build your Jekyll site.\nWe've prepared an ",[16,816,819],{"href":817,"rel":818},"https://gitlab.com/jekyll-themes/default-bundler",[],"example"," for that. Also, if you want to use a specific Jekyll version, you can\nfind an ",[16,822,819],{"href":823,"rel":824},"https://gitlab.com/jekyll-themes/carte-noire",[]," in the ",[16,827,830],{"href":828,"rel":829},"https://gitlab.com/groups/jekyll-themes",[],"Jekyll Themes","\ngroup I set up for the purposes of this post.\nAnd of course, since you are the one who controls how GitLab CI builds your site,\nyou are free to use any ",[16,833,836],{"href":834,"rel":835},"https://jekyllrb.com/docs/plugins/",[],"Jekyll Plugins",". ",[250,839,840],{},"Yep!",[83,842,844],{"id":843},"option-c-gitlab-ci-for-hexo-websites","Option C: GitLab CI for Hexo websites",[12,846,847,848,850,851,856,857,860],{},"Let's see another example. ",[53,849,62],{}," is a powerful blog-aware framework built with ",[16,852,855],{"href":853,"rel":854},"https://nodejs.org/en/",[],"NodeJS",",\na server-side JavaScript environment based on ",[53,858,859],{},"Google V8"," high-performance engine.",[12,862,863,864,866],{},"To build our Hexo site, we can start with this ",[203,865,239],{},":",[483,868,870],{"className":485,"code":869,"language":487,"meta":488,"style":488},"image: node:4.2.2\n\npages:\n  cache:\n    paths:\n    - node_modules/\n\n  script:\n  - npm install hexo-cli -g\n  - npm install\n  - hexo deploy\n  artifacts:\n    paths:\n    - public\n  only:\n    - main\n\n",[203,871,872,881,885,891,898,904,911,915,921,928,935,942,949,956,963,970],{"__ignoreMap":488},[53,873,874,876,878],{"class":493,"line":494},[53,875,704],{"class":497},[53,877,511],{"class":501},[53,879,880],{"class":514},"node:4.2.2\n",[53,882,883],{"class":493,"line":505},[53,884,715],{"emptyLinePlaceholder":714},[53,886,887,889],{"class":493,"line":518},[53,888,498],{"class":497},[53,890,502],{"class":501},[53,892,893,896],{"class":493,"line":526},[53,894,895],{"class":497},"  cache",[53,897,502],{"class":501},[53,899,900,902],{"class":493,"line":535},[53,901,562],{"class":497},[53,903,502],{"class":501},[53,905,906,908],{"class":493,"line":543},[53,907,570],{"class":501},[53,909,910],{"class":514},"node_modules/\n",[53,912,913],{"class":493,"line":551},[53,914,715],{"emptyLinePlaceholder":714},[53,916,917,919],{"class":493,"line":559},[53,918,521],{"class":497},[53,920,502],{"class":501},[53,922,923,925],{"class":493,"line":567},[53,924,529],{"class":501},[53,926,927],{"class":514},"npm install hexo-cli -g\n",[53,929,930,932],{"class":493,"line":576},[53,931,529],{"class":501},[53,933,934],{"class":514},"npm install\n",[53,936,937,939],{"class":493,"line":584},[53,938,529],{"class":501},[53,940,941],{"class":514},"hexo deploy\n",[53,943,945,947],{"class":493,"line":944},12,[53,946,554],{"class":497},[53,948,502],{"class":501},[53,950,952,954],{"class":493,"line":951},13,[53,953,562],{"class":497},[53,955,502],{"class":501},[53,957,959,961],{"class":493,"line":958},14,[53,960,570],{"class":501},[53,962,573],{"class":514},[53,964,966,968],{"class":493,"line":965},15,[53,967,579],{"class":497},[53,969,502],{"class":501},[53,971,973,975],{"class":493,"line":972},16,[53,974,570],{"class":501},[53,976,589],{"class":514},[12,978,979,980,985,986,989,990,992,993,996,997,1000,1001,1004,1005,1007,1008,1010,1011,1013,1014,1016,1017,318],{},"Note that the ",[16,981,984],{"href":982,"rel":983},"https://hub.docker.com/_/node/",[],"Docker image"," we require is ",[203,987,988],{},"node:4.2.2",".\nWe are archiving ",[203,991,301],{}," modules into the ",[203,994,995],{},"cache",", installing ",[203,998,999],{},"hexo-cli"," and deploying\nour ",[203,1002,1003],{},"hexo"," site to the default ",[203,1006,446],{}," directory, uploaded to GitLab as ",[203,1009,629],{},".\nThe ",[203,1012,498],{}," job is ",[203,1015,644],{}," affecting the ",[203,1018,314],{},[12,1020,106,1021,1026,1027,1032,1033,1038,1039,1043],{},[16,1022,1025],{"href":1023,"rel":1024},"https://gitlab.com/groups/pages",[],"Pages"," group you will find a default ",[16,1028,1031],{"href":1029,"rel":1030},"https://gitlab.com/pages/hexo",[],"Hexo site","\ndeployed with GitLab Pages, and on ",[16,1034,1037],{"href":1035,"rel":1036},"https://gitlab.com/themes-templates",[],"this group",", another ",[16,1040,819],{"href":1041,"rel":1042},"https://gitlab.com/themes-templates/hexo",[],"\nwith a slightly different configuration.",[83,1045,1047],{"id":1046},"step-3-upload-your-website-content","Step 3: Upload your website content",[12,1049,1050],{},"Push the content to your remote project and keep an eye on the build!",[12,1052,1053,1056,1057,1060,1061,1063,1064,1067,1068,1063,1070,1060,1072,1074,1075,1078],{},[42,1054,1055],{},"Don't forget:"," when you are using GitLab Pages with a Static Site Generator,\ndo not upload the directory which your SSG generated locally,\notherwise you'll have duplicated contents and you might face build errors.\nFor example, do not commit the ",[203,1058,1059],{},"_site"," directory (",[53,1062,55],{},") or the ",[203,1065,1066],{},"build"," directory\n(",[53,1069,65],{},[203,1071,446],{},[53,1073,62],{},"). You can do this automatically by adding\nthem to a ",[203,1076,1077],{},".gitignore"," file, placed at your project's root directory.",[12,1080,1081,1082,1084],{},"E.g., if you are building a Jekyll site, your ",[203,1083,1077],{}," will have this line:",[483,1086,1091],{"className":1087,"code":1089,"language":1090,"meta":488},[1088],"language-text","_site\n","text",[203,1092,1089],{"__ignoreMap":488},[12,1094,1095,1096,1098,1099,28],{},"A ",[203,1097,1077],{}," is very useful to avoid uploading to your remote repository any file or folder within your project.\nIf you want to know more about it, check the ",[16,1100,1103,1105],{"href":1101,"rel":1102},"https://git-scm.com/docs/gitignore",[],[203,1104,1077],{}," official docs",[83,1107,1109],{"id":1108},"step-4-add-your-custom-domain","Step 4: Add your custom domain",[12,1111,1112,1114,1115,28],{},[42,1113,134],{}," Custom CNAMEs with TLS support were introduced in ",[16,1116,1119],{"href":1117,"rel":1118},"https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/173",[],"GitLab EE 8.5",[12,1121,1122,1123,1128],{},"If you want, you are free to ",[16,1124,1127],{"href":1125,"rel":1126},"https://docs.gitlab.com/pages/README/#add-a-custom-domain-to-your-pages-website",[],"add your own domain(s) name"," to your website hosted by GitLab.com.",[12,1130,1131,1132,28],{},"It's not required though, you can always use the standard\n",[16,1133,1136],{"href":1134,"rel":1135},"https://docs.gitlab.com/user/project/pages/getting_started_part_one/#gitlab-pages-default-domain-names",[],"GitLab Pages default domain names",[12,1138,1139],{},[250,1140,1141],{},"Features",[88,1143,1144,1154,1183],{},[91,1145,1146,1147,1150,1151,370],{},"Besides including your own domain, you can add your custom ",[42,1148,1149],{},"subdomain"," to your GitLab Pages project (e.g., ",[203,1152,1153],{},"subdomain.example.com",[91,1155,1156,1157,1160,1161,1164,1165,45,1168,66,1171,1174,1175,1178,1179,1182],{},"You can enter more than one domain alias ",[42,1158,1159],{},"per project"," (e.g., ",[203,1162,1163],{},"example.com",",\n",[203,1166,1167],{},"example.net",[203,1169,1170],{},"my.example.org",[203,1172,1173],{},"another-example.com"," pointing to your project under ",[203,1176,1177],{},"mynamespace.gitlab.io"," or\n",[203,1180,1181],{},"mynamespace.gitlab.io/myproject","). A domain alias is like having multiple front doors to one location.",[91,1184,1185,1186,1189],{},"If you want to enable an HTTPS secure connection to your domains, you can affix your own SSL/TLS digital\ncertificate to ",[42,1187,1188],{},"each"," custom domain or subdomain you've added to your projects.",[12,1191,1192],{},[250,1193,1194],{},"Steps to set up a custom domain",[88,1196,1197,1207,1213,1216,1222],{},[91,1198,1199,1200,1203,1204],{},"From your project's dashboard, go to ",[42,1201,1202],{},"Settings"," () ",[42,1205,1206],{},"> Pages > New Domain",[91,1208,1209,1210],{},"Add your domain to the first field: ",[203,1211,1212],{},"mydomain.com",[91,1214,1215],{},"If you have an SSL/TLS digital certificate and its key, add them to their respective fields.\nIf you don't, just leave the fields blank.",[91,1217,1218,1219,28],{},"Click on ",[42,1220,1221],{},"Create New Domain",[91,1223,1224,1225,1234,1235,866],{},"Finally, access your domain control panel and create a new ",[16,1226,1229,1230,1233],{"href":1227,"rel":1228},"https://support.dnsimple.com/articles/a-record/",[],"DNS ",[203,1231,1232],{},"A"," record"," pointing\nto the ",[16,1236,1239],{"href":1237,"rel":1238},"https://docs.gitlab.com/user/gitlab_com/#gitlab-pages",[],"IP of GitLab Pages server",[483,1241,1244],{"className":1242,"code":1243,"language":1090,"meta":488},[1088],"mydomain.com A 35.185.44.232\n",[203,1245,1243],{"__ignoreMap":488},[12,1247,1248,1250,1251,614,1254,1257],{},[42,1249,134],{}," This GitLab Pages IP address for GitLab.com changed from ",[203,1252,1253],{},"52.167.214.135",[203,1255,1256],{},"35.185.44.232"," in August 2018.",[12,1259,1260,1261,866],{},"Alternatively, a similar procedure can be applied for ",[42,1262,1263],{},"custom subdomains",[88,1265,1266,1272],{},[91,1267,1268,1269],{},"Add the subdomain to the first field: ",[203,1270,1271],{},"subdomain.mydomain.com",[91,1273,1274,1275,1282,1283,866],{},"Then create a new ",[16,1276,1229,1279,1233],{"href":1277,"rel":1278},"https://en.wikipedia.org/wiki/CNAME_record",[],[203,1280,1281],{},"CNAME"," pointing to ",[203,1284,1285],{},"myusername.gitlab.io",[483,1287,1290],{"className":1288,"code":1289,"language":1090,"meta":488},[1088],"subdomain.mydomain.com CNAME myusername.gitlab.io\n",[203,1291,1289],{"__ignoreMap":488},[12,1293,1294],{},"Repeat these steps for any additional domain aliases.",[12,1296,1297,1298,1303],{},"Note that how you set up your DNS records will depend upon which company you\nused to register your domain name. Every company has its own methods for DNS Zone Management.\nOn this link you can find an ",[16,1299,1302],{"href":1300,"rel":1301},"http://docs.businesscatalyst.com/user-manual/site-settings/site-domains/updating-dns-records-with-a-domain-registrar-external-dns",[],"overview for some providers",",\nit might help you to follow through. Please contact your provider directly if you need some extra help.",[12,1305,1306],{},"Ordinarily, DNS propagation needs some time to take effect, so don't worry if you can't access your\nwebsite under your custom domain instantaneously. Wait a few minutes and check it again.",[97,1308,1309],{"id":665},"Examples",[12,1311,1312,1313,1316],{},"Check out the ",[16,1314,1025],{"href":1023,"rel":1315},[]," official group for a list of example projects,\nwhere you can explore some good options for Static Site Generators for Ruby, NodeJS and Python environments.\nYou can also find more specific examples on the following groups, which I prepared for the purposes of this post:",[88,1318,1319,1325,1333,1340],{},[91,1320,1321,1324],{},[16,1322,830],{"href":828,"rel":1323},[]," (Ruby/Jekyll)",[91,1326,1327,1332],{},[16,1328,1331],{"href":1329,"rel":1330},"https://gitlab.com/groups/middleman-themes",[],"Middleman Themes"," (Ruby/Middleman)",[91,1334,1335,1339],{},[16,1336,1338],{"href":1035,"rel":1337},[],"Themes and Templates"," (Miscellaneous)",[91,1341,1342,1347],{},[16,1343,1346],{"href":1344,"rel":1345},"https://gitlab.com/groups/html-themes",[],"HTML Themes"," (plain HTML)",[12,1349,1350,1352],{},[42,1351,134],{}," these themes, templates and SSGs were casually chosen and listed on this\npost to provide you with some distinct GitLab CI configurations.",[97,1354,1356],{"id":1355},"faq","FAQ",[12,1358,1359],{},[42,1360,1361],{},"Is GitLab Pages free to use?",[12,1363,1364,1365,1368,1369,1372,1373,1377,1378,1383],{},"Yes, it is! On ",[16,1366,27],{"href":24,"rel":1367,"title":26},[]," you can create your free account\nand enjoy all its ",[16,1370,1371],{"href":455},"features",", including unlimited private repositories,\nprojects, websites, and contributors. Also, you'll have 10GB disk space per project, ",[16,1374,1376],{"href":1237,"rel":1375},[],"1GB per Pages artifacts",",\nand unlimited total disk space. Why don't you take a peek at the ",[16,1379,1382],{"href":1380,"rel":1381},"https://gitlab.com/explore",[],"public projects","?",[12,1385,1386],{},[42,1387,1388],{},"What types of websites can I host on GitLab Pages?",[12,1390,1391],{},"GitLab Pages supports static websites only, including plain HTML, CSS, and JavaScript, as well as sites built with any Static Site Generator such as Jekyll, Hugo, Hexo, Middleman, or Pelican. Dynamic server-side languages like PHP and database connections are not supported.",[12,1393,1394],{},[42,1395,1396],{},"What are the two types of websites I can create with GitLab Pages?",[12,1398,1399],{},"You can create User or Group websites, which allow one site per user or group, or Project websites, which allow as many sites as you want under a given namespace.",[12,1401,1402],{},[42,1403,1404,1405,1407],{},"Where is the ",[203,1406,446],{}," folder?",[12,1409,1410,1411,1414],{},"When a build succeeds, you'll find your static site at your project's ",[42,1412,1413],{},"Pipelines > Builds > Build ID > Browse",".\nYou can download the artifacts from the same screen.",[12,1416,1417],{},[339,1418],{"alt":1419,"src":1420},"Build Artifacts - Browse or Download","https://res.cloudinary.com/about-gitlab-com/image/upload/v1782398421/blog/Content%20Images/gitlab-pages/gitlab-browse-download-artifacts.png",[12,1422,1423],{},[42,1424,1425,1426,1428],{},"What is the ",[203,1427,239],{}," file and why do I need it?",[12,1430,1431,1432,1434],{},"The ",[203,1433,239],{}," file is the GitLab CI configuration file that tells a Runner how to build and deploy your website. It must be placed in the root directory of your project and is required for GitLab Pages to function correctly.",[12,1436,1437],{},[42,1438,1439],{},"Can I use a custom domain with GitLab Pages?",[12,1441,1442,1443,1445,1446,1448,1449,1452],{},"Yes, you can add one or more custom domains or subdomains to your GitLab Pages project. For a root domain, you create a DNS ",[203,1444,1232],{}," record pointing to the GitLab Pages server IP, and for subdomains, you create a ",[203,1447,1281],{}," record pointing to your ",[203,1450,1451],{},"username.gitlab.io"," address.",[12,1454,1455],{},[42,1456,1457],{},"Can I use SSL/TLS certificates with my custom domain?",[12,1459,1460,1461,1465,1466,1469],{},"Yes, you can attach your own SSL/TLS digital certificate to each custom domain or subdomain you add. Free certificate options such as ",[16,1462,1464],{"href":1463},"/blog/tutorial-securing-your-gitlab-pages-with-tls-and-letsencrypt/","Let's Encrypt"," or ",[53,1467,1468],{},"Cloudflare"," are also supported.",[12,1471,1472],{},[42,1473,1474],{},"Where can I find my site's built files after a successful deployment?",[12,1476,1477],{},"After a successful build, you can find your static site by navigating to your project's Pipelines, then Builds, then the specific Build ID, and clicking Browse. You can also download the artifacts from the same screen.",[12,1479,1480],{},[42,1481,1482,1483,1485],{},"Can I validate my ",[203,1484,239],{}," before pushing it to my project?",[12,1487,1488,1489,1491],{},"Yes, GitLab provides a CI Lint tool accessible from your project's Pipelines view that lets you validate your ",[203,1490,239],{}," syntax before pushing it to your repository.",[97,1493,1495],{"id":1494},"getting-help","Getting Help",[12,1497,1498,1499,1503,1504,1508],{},"If you need some help regarding GitLab Pages on GitLab.com,\nfeel free to use one of ",[16,1500,1502],{"href":1501},"/get-help/","our channels",". You can also open an issue on the ",[16,1505,1025],{"href":1506,"rel":1507},"https://gitlab.com/pages/pages.gitlab.io/issues",[]," group.",[12,1510,1511],{},[16,1512],{"name":1513},"conclusions",[97,1515,1517],{"id":1516},"conclusion","Conclusion",[12,1519,1520,1521,1526],{},"Hopefully now you understand how ",[42,1522,1523],{},[16,1524,20],{"href":18,"rel":1525},[]," works and how to create your new site.",[12,1528,1529,1530,1535],{},"Follow ",[16,1531,1534],{"href":1532,"rel":1533},"https://twitter.com/gitlab",[],"@GitLab"," on Twitter and stay tuned for updates!",[12,1537,1538],{},"We're looking forward to seeing your sites!",[12,1540,1541,1543],{},[42,1542,134],{}," this post has been updated (June 17th, 2016) to match the new GitLab UI.",[97,1545,1547],{"id":1546},"about-guest-author-marcia-ramos","About guest author Marcia Ramos",[12,1549,1550,1555,1556,1559],{},[16,1551,1554],{"href":1552,"rel":1553},"https://gitlab.com/marcia",[],"Marcia"," is a backend web developer specialized in WordPress and Jekyll sites at ",[53,1557,1558],{},"Virtua Creative",",\nthough she does some frontend too. Her daily work is based on version-controlled systems for almost 15 years.\nShe is driven by her thirst for knowledge and her eagerness to continuously expand her horizons.\nWhen she is not coding, she is writing articles, studying, teaching or contributing to open source projects here and there.\nUpdate: she's joined the GitLab Team in May, 2016.",[1561,1562,1563],"style",{},"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 .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);}",{"title":488,"searchDepth":505,"depth":505,"links":1565},[1566,1567,1568,1571,1572,1573,1583,1584,1585,1586,1587],{"id":85,"depth":518,"text":86},{"id":99,"depth":505,"text":100},{"id":161,"depth":505,"text":162,"children":1569},[1570],{"id":184,"depth":518,"text":185},{"id":223,"depth":505,"text":224},{"id":355,"depth":505,"text":356},{"id":385,"depth":505,"text":386,"children":1574},[1575,1576,1578,1579,1580,1581,1582],{"id":398,"depth":518,"text":399},{"id":459,"depth":518,"text":1577},"Step 2: Add the configuration file: .gitlab-ci.yml",{"id":468,"depth":518,"text":469},{"id":653,"depth":518,"text":654},{"id":843,"depth":518,"text":844},{"id":1046,"depth":518,"text":1047},{"id":1108,"depth":518,"text":1109},{"id":665,"depth":505,"text":1309},{"id":1355,"depth":505,"text":1356},{"id":1494,"depth":505,"text":1495},{"id":1516,"depth":505,"text":1517},{"id":1546,"depth":505,"text":1547},"engineering","2016-04-07","Learn how to host your website on GitLab.com with GitLab Pages","md",null,false,"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749671069/Blog/Hero%20Images/gitlab-pages-setup-cover.jpg",{"excerpt":1596},{"type":9,"value":1597},[1598,1606,1608,1628],[12,1599,14,1600,21,1603,28],{},[16,1601,20],{"href":18,"rel":1602},[],[16,1604,27],{"href":24,"rel":1605,"title":26},[],[12,1607,31],{},[12,1609,34,1610,40,1613,45,1615,51,1618,56,1620,56,1622,56,1624,66,1626,28],{},[16,1611,39],{"href":37,"rel":1612},[],[42,1614,44],{},[16,1616,50],{"href":48,"rel":1617},[],[53,1619,55],{},[53,1621,59],{},[53,1623,62],{},[53,1625,65],{},[53,1627,69],{},[12,1629,72,1630,78],{},[16,1631,77],{"href":75,"rel":1632},[],"/en-us/blog/gitlab-pages-setup",{"title":5,"description":1590,"ogTitle":5,"ogDescription":1590,"noIndex":1593,"ogImage":1594,"ogUrl":1635,"ogSiteName":1636,"ogType":1637,"canonicalUrls":1635},"https://about.gitlab.com/blog/gitlab-pages-setup","https://about.gitlab.com","article","gitlab-pages-setup","en-us/blog/gitlab-pages-setup","BlogPost","BkbAugeCnnFc-vOlR8a-loA5FGWFLrpYxbKlQ-91Oy0",{"logo":1643,"freeTrial":1648,"sales":1653,"login":1658,"items":1663,"search":1996,"minimal":2028,"duo":2047,"switchNav":2056,"pricingDeployment":2067},{"config":1644},{"href":1645,"dataGaName":1646,"dataGaLocation":1647},"/","gitlab logo","header",{"text":1649,"config":1650},"Get free trial",{"href":1651,"dataGaName":1652,"dataGaLocation":1647},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com&glm_content=default-saas-trial/","free trial",{"text":1654,"config":1655},"Request a demo",{"href":1656,"dataGaName":1657,"dataGaLocation":1647},"/request-a-demo/","sales",{"text":1659,"config":1660},"Sign in",{"href":1661,"dataGaName":1662,"dataGaLocation":1647},"https://gitlab.com/users/sign_in/","sign in",[1664,1749,1837,1841,1920,1974],{"text":1665,"left":714,"config":1666,"menu":1668},"Platform",{"dataNavLevelOne":1667},"platform",{"type":1669,"link":1670,"columns":1674,"feature":1738},"lists",{"text":1671,"config":1672},"Explore the Platform",{"href":1673,"dataGaName":1667,"dataGaLocation":1647},"/platform/",[1675,1697,1720],{"title":1676,"items":1677},"DevOps",[1678,1682,1687,1692],{"text":1679,"config":1680},"CI/CD",{"href":271,"dataGaLocation":1647,"dataGaName":1681},"ci/cd",{"text":1683,"config":1684},"Source Code Management",{"href":1685,"dataGaLocation":1647,"dataGaName":1686},"/solutions/source-code-management/","source code management",{"text":1688,"config":1689},"Agile Delivery",{"href":1690,"dataGaLocation":1647,"dataGaName":1691},"/solutions/agile-delivery/","agile delivery",{"text":1693,"config":1694},"Artifact Management",{"href":1695,"dataGaLocation":1647,"dataGaName":1696},"/artifact-central/","artifact management",{"title":1698,"items":1699},"Security & Governance",[1700,1705,1710,1715],{"text":1701,"config":1702},"Application Security Testing",{"href":1703,"dataGaLocation":1647,"dataGaName":1704},"/solutions/application-security-testing/","application security testing",{"text":1706,"config":1707},"Governance & Compliance",{"href":1708,"dataGaLocation":1647,"dataGaName":1709},"/solutions/software-compliance/","governance and compliance",{"text":1711,"config":1712},"Secrets Management",{"href":1713,"dataGaLocation":1647,"dataGaName":1714},"/gitlab-secrets-manager/","secrets management",{"text":1716,"config":1717},"Supply Chain Security",{"href":1718,"dataGaLocation":1647,"dataGaName":1719},"/solutions/supply-chain/","supply chain security",{"title":1721,"items":1722},"Agentic AI & Context",[1723,1728,1733],{"text":1724,"config":1725},"Duo Agent Platform",{"href":1726,"dataGaLocation":1647,"dataGaName":1727},"/gitlab-duo-agent-platform/","duo agent platform",{"text":1729,"config":1730},"Orbit Context Graph",{"href":1731,"dataGaLocation":1647,"dataGaName":1732},"/gitlab-orbit/","orbit",{"text":1734,"config":1735},"Visibility & Measurement",{"href":1736,"dataGaLocation":1647,"dataGaName":1737},"/solutions/visibility-measurement/","visibility and measurement",{"config":1739,"title":1742,"text":1743,"link":1744},{"background":1740,"textColor":1741},"url('https://res.cloudinary.com/about-gitlab-com/image/upload/v1790185102/o7dn32anqcb6z8dgd3as.jpg')","#000","GitLab Orbit is generally available","Higher agent accuracy, lower token cost",{"text":1745,"config":1746},"Read the announcement",{"href":1747,"dataGaName":1748,"dataGaLocation":1647},"/blog/gitlab-orbit-ga/","orbit ga announcement",{"text":1750,"left":714,"config":1751,"menu":1753},"Solutions",{"dataNavLevelOne":1752},"solutions",{"type":1669,"link":1754,"columns":1758,"feature":1828},{"text":1755,"config":1756},"View all Solutions",{"href":1757,"dataGaName":1752,"dataGaLocation":1647},"/solutions/",[1759,1777,1795],{"title":1760,"items":1761},"Outcomes",[1762,1767,1772],{"text":1763,"config":1764},"DevOps Modernization",{"href":1765,"dataGaLocation":1647,"dataGaName":1766},"/assessments/devops-modernization-assessment/","devops modernization",{"text":1768,"config":1769},"Security Modernization",{"href":1770,"dataGaLocation":1647,"dataGaName":1771},"/assessments/security-modernization-assessment/","security modernization",{"text":1773,"config":1774},"AI Modernization",{"href":1775,"dataGaLocation":1647,"dataGaName":1776},"/assessments/ai-modernization-assessment/","ai modernization",{"title":1778,"items":1779},"By size",[1780,1785,1790],{"text":1781,"config":1782},"Enterprise",{"href":1783,"dataGaLocation":1647,"dataGaName":1784},"/enterprise/","enterprise",{"text":1786,"config":1787},"Small Business",{"href":1788,"dataGaLocation":1647,"dataGaName":1789},"/small-business/","small business",{"text":1791,"config":1792},"Startups",{"href":1793,"dataGaLocation":1647,"dataGaName":1794},"/solutions/startups/","startups",{"title":1796,"items":1797},"Industries",[1798,1803,1808,1813,1818,1823],{"text":1799,"config":1800},"Financial Services",{"href":1801,"dataGaLocation":1647,"dataGaName":1802},"/solutions/finance/","financial services",{"text":1804,"config":1805},"Public Sector",{"href":1806,"dataGaLocation":1647,"dataGaName":1807},"/solutions/public-sector/","public sector",{"text":1809,"config":1810},"Telecommunications",{"href":1811,"dataGaLocation":1647,"dataGaName":1812},"/solutions/telecommunications/","telecommunications",{"text":1814,"config":1815},"Automotive",{"href":1816,"dataGaLocation":1647,"dataGaName":1817},"/solutions/automotive/","automotive",{"text":1819,"config":1820},"Education",{"href":1821,"dataGaLocation":1647,"dataGaName":1822},"/solutions/education/","education",{"text":1824,"config":1825},"Aerospace",{"href":1826,"dataGaLocation":1647,"dataGaName":1827},"/solutions/aerospace/","aerospace",{"config":1829,"title":1830,"text":1831,"link":1832},{"background":1740,"textColor":1741},"GitLab Security Standard","Learn how to harden your software factory and let AI agents earn autonomy, without trading away security.",{"text":1833,"config":1834},"Explore the standard",{"href":1835,"dataGaName":1836,"dataGaLocation":1647},"/gitlab-security-standard/","gitlab security standard",{"text":1838,"config":1839},"Pricing",{"href":455,"dataGaName":1840,"dataGaLocation":1647,"dataNavLevelOne":1840},"pricing",{"text":1842,"config":1843,"menu":1845},"Resources",{"dataNavLevelOne":1844},"resources",{"type":1669,"link":1846,"columns":1850,"feature":1911},{"text":1847,"config":1848},"View all resources",{"href":1849,"dataGaName":1844,"dataGaLocation":1647},"/resources/",[1851,1883],{"title":1852,"items":1853},"Discover",[1854,1858,1863,1868,1873,1878],{"text":1855,"config":1856},"Docs",{"href":1857,"dataGaName":181,"dataGaLocation":1647},"https://docs.gitlab.com/",{"text":1859,"config":1860},"University",{"href":1861,"dataGaName":1862,"dataGaLocation":1647},"https://university.gitlab.com/","university",{"text":1864,"config":1865},"Demo Series",{"href":1866,"dataGaName":1867,"dataGaLocation":1647},"/gitlab-technical-demo-series/","demo series",{"text":1869,"config":1870},"Demo Hub",{"href":1871,"dataGaName":1872,"dataGaLocation":1647},"/demo-hub/","demo hub",{"text":1874,"config":1875},"Services",{"href":1876,"dataGaName":1877,"dataGaLocation":1647},"/services/","services",{"text":1879,"config":1880},"Well Architected",{"href":1881,"dataGaName":1882,"dataGaLocation":1647},"/resources/well-architected/","well architected",{"title":1884,"items":1885},"Connect",[1886,1891,1896,1901,1906],{"text":1887,"config":1888},"Blog",{"href":1889,"dataGaName":1890,"dataGaLocation":1647},"/blog/","blog",{"text":1892,"config":1893},"Community",{"href":1894,"dataGaName":1895,"dataGaLocation":1647},"/community/","community",{"text":1897,"config":1898},"Customers",{"href":1899,"dataGaName":1900,"dataGaLocation":1647},"/customers/","customers",{"text":1902,"config":1903},"Partners",{"href":1904,"dataGaName":1905,"dataGaLocation":1647},"/partners/","partners",{"text":1907,"config":1908},"Events",{"href":1909,"dataGaName":1910,"dataGaLocation":1647},"/events/","events",{"config":1912,"title":1913,"text":1914,"link":1915},{"background":1740,"textColor":1741},"What’s new in GitLab","Stay updated with our latest features and improvements.",{"text":1916,"config":1917},"Read the latest",{"href":1918,"dataGaName":1919,"dataGaLocation":1647},"/whats-new/","whats new",{"text":1921,"config":1922,"menu":1924},"Company",{"dataNavLevelOne":1923},"company",{"type":1669,"columns":1925},[1926],{"items":1927},[1928,1933,1939,1944,1949,1954,1959,1964,1969],{"text":1929,"config":1930},"About",{"href":1931,"dataGaName":1932,"dataGaLocation":1647},"/company/","about",{"text":1934,"config":1935,"footerGa":1938},"Jobs",{"href":1936,"dataGaName":1937,"dataGaLocation":1647},"/jobs/","jobs",{"dataGaName":1937},{"text":1940,"config":1941},"Press",{"href":1942,"dataGaName":1943,"dataGaLocation":1647},"/press/","press",{"text":1945,"config":1946},"Handbook",{"href":1947,"dataGaName":1948,"dataGaLocation":1647},"https://handbook.gitlab.com/","handbook",{"text":1950,"config":1951},"Leadership",{"href":1952,"dataGaName":1953,"dataGaLocation":1647},"/company/team/e-group/","leadership",{"text":1955,"config":1956},"Investor relations",{"href":1957,"dataGaName":1958,"dataGaLocation":1647},"https://ir.gitlab.com/overview/default.aspx","investor relations",{"text":1960,"config":1961},"Trust Center",{"href":1962,"dataGaName":1963,"dataGaLocation":1647},"/security/","trust center",{"text":1965,"config":1966},"AI Transparency Center",{"href":1967,"dataGaName":1968,"dataGaLocation":1647},"/ai-transparency-center/","ai transparency center",{"text":1970,"config":1971},"Newsletter",{"href":1972,"dataGaName":1973,"dataGaLocation":1647},"/company/contact/#contact-forms","newsletter",{"text":1975,"config":1976,"menu":1977},"Contact us",{"dataNavLevelOne":1923},{"type":1669,"columns":1978},[1979],{"items":1980},[1981,1986,1991],{"text":1982,"config":1983},"Talk to sales",{"href":1984,"dataGaName":1985,"dataGaLocation":1647},"/sales/","talk to sales",{"text":1987,"config":1988},"Support portal",{"href":1989,"dataGaName":1990,"dataGaLocation":1647},"https://support.gitlab.com/hc/en-us","support portal",{"text":1992,"config":1993},"Customer portal",{"href":1994,"dataGaName":1995,"dataGaLocation":1647},"https://customers.gitlab.com/customers/sign_in/","customer portal",{"close":1997,"login":1998,"suggestions":2005},"Close",{"text":1999,"link":2000},"To search repositories and projects, login to",{"text":2001,"config":2002},"gitlab.com",{"href":1661,"dataGaName":2003,"dataGaLocation":2004},"search login","search",{"text":2006,"default":2007},"Suggestions",[2008,2011,2014,2016,2020,2024],{"text":2009,"config":2010},"GitLab Duo Agent Platform",{"href":1726,"dataGaName":2009,"dataGaLocation":2004},{"text":2012,"config":2013},"Code Suggestions (AI)",{"href":1726,"dataGaName":2012,"dataGaLocation":2004},{"text":1679,"config":2015},{"href":271,"dataGaName":1679,"dataGaLocation":2004},{"text":2017,"config":2018},"GitLab on AWS",{"href":2019,"dataGaName":2017,"dataGaLocation":2004},"/partners/technology-partners/aws/",{"text":2021,"config":2022},"GitLab on Google Cloud",{"href":2023,"dataGaName":2021,"dataGaLocation":2004},"/partners/technology-partners/google-cloud-platform/",{"text":2025,"config":2026},"Why GitLab?",{"href":2027,"dataGaName":2025,"dataGaLocation":2004},"/why-gitlab/",{"freeTrial":2029,"mobileIcon":2034,"desktopIcon":2039,"secondaryButton":2042},{"text":2030,"config":2031},"Start free trial",{"href":2032,"dataGaName":1652,"dataGaLocation":2033},"https://gitlab.com/-/trials/new/","nav",{"altText":2035,"config":2036},"Gitlab Icon",{"src":2037,"dataGaName":2038,"dataGaLocation":2033},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203874/jypbw1jx72aexsoohd7x.svg","gitlab icon",{"altText":2035,"config":2040},{"src":2041,"dataGaName":2038,"dataGaLocation":2033},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1758203875/gs4c8p8opsgvflgkswz9.svg",{"text":2043,"config":2044},"Get Started",{"href":2045,"dataGaName":2046,"dataGaLocation":2033},"https://gitlab.com/-/trial_registrations/new?glm_source=about.gitlab.com/get-started/","get started",{"freeTrial":2048,"mobileIcon":2052,"desktopIcon":2054},{"text":2049,"config":2050},"Learn more about GitLab Duo",{"href":1726,"dataGaName":2051,"dataGaLocation":2033},"gitlab duo",{"altText":2035,"config":2053},{"src":2037,"dataGaName":2038,"dataGaLocation":2033},{"altText":2035,"config":2055},{"src":2041,"dataGaName":2038,"dataGaLocation":2033},{"button":2057,"mobileIcon":2062,"desktopIcon":2064},{"text":2058,"config":2059},"/switch",{"href":2060,"dataGaName":2061,"dataGaLocation":2033},"#contact","switch",{"altText":2035,"config":2063},{"src":2037,"dataGaName":2038,"dataGaLocation":2033},{"altText":2035,"config":2065},{"src":2066,"dataGaName":2038,"dataGaLocation":2033},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1773335277/ohhpiuoxoldryzrnhfrh.png",{"freeTrial":2068,"mobileIcon":2073,"desktopIcon":2075},{"text":2069,"config":2070},"Back to pricing",{"href":455,"dataGaName":2071,"dataGaLocation":2033,"icon":2072},"back to pricing","GoBack",{"altText":2035,"config":2074},{"src":2037,"dataGaName":2038,"dataGaLocation":2033},{"altText":2035,"config":2076},{"src":2041,"dataGaName":2038,"dataGaLocation":2033},{"title":2078,"button":2079,"config":2083},"GitLab Orbit is generally available. Increase agent accuracy and lower token cost",{"text":1745,"config":2080},{"href":1747,"dataGaName":2081,"dataGaLocation":2082},"orbit-ga-banner","global-banner",{"layout":2084,"disabled":1593},"release",{"data":2086},{"text":2087,"config":2088,"items":2092,"minimal":2320},"Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license",{"twitter":1532,"facebook":2089,"youtube":2090,"linkedin":2091},"https://www.facebook.com/gitlab","https://www.youtube.com/channel/UCnMGQ8QHMAnVIsI3xJrihhg","https://www.linkedin.com/company/gitlab-com",[2093,2141,2200,2247,2288],{"title":1838,"links":2094,"subMenu":2110},[2095,2100,2105],{"text":2096,"config":2097},"View plans",{"href":455,"dataGaName":2098,"dataGaLocation":2099},"view plans","footer",{"text":2101,"config":2102},"Why Premium?",{"href":2103,"dataGaName":2104,"dataGaLocation":2099},"/pricing/premium/","why premium",{"text":2106,"config":2107},"Why Ultimate?",{"href":2108,"dataGaName":2109,"dataGaLocation":2099},"/pricing/ultimate/","why ultimate",[2111],{"title":2112,"links":2113},"Contact Us",[2114,2117,2119,2121,2126,2131,2136],{"text":2115,"config":2116},"Contact sales",{"href":1984,"dataGaName":1657,"dataGaLocation":2099},{"text":1987,"config":2118},{"href":1989,"dataGaName":1990,"dataGaLocation":2099},{"text":1992,"config":2120},{"href":1994,"dataGaName":1995,"dataGaLocation":2099},{"text":2122,"config":2123},"Status",{"href":2124,"dataGaName":2125,"dataGaLocation":2099},"https://status.gitlab.com/","status",{"text":2127,"config":2128},"Terms of use",{"href":2129,"dataGaName":2130,"dataGaLocation":2099},"/terms/","terms of use",{"text":2132,"config":2133},"Privacy statement",{"href":2134,"dataGaName":2135,"dataGaLocation":2099},"/privacy/","privacy statement",{"text":2137,"config":2138},"Cookie preferences",{"dataGaName":2139,"dataGaLocation":2099,"id":2140,"isOneTrustButton":714},"cookie preferences","ot-sdk-btn",{"title":1665,"links":2142,"subMenu":2158},[2143,2146,2148,2150,2152,2154],{"text":2144,"config":2145},"Explore the platform",{"href":1673,"dataGaName":1667,"dataGaLocation":2099},{"text":1724,"config":2147},{"href":1726,"dataGaName":1727,"dataGaLocation":2099},{"text":1679,"config":2149},{"href":271,"dataGaName":1681,"dataGaLocation":2099},{"text":1729,"config":2151},{"href":1731,"dataGaName":1732,"dataGaLocation":2099},{"text":1711,"config":2153},{"href":1713,"dataGaName":1714,"dataGaLocation":2099},{"text":2155,"config":2156},"Why GitLab",{"href":2027,"dataGaName":2157,"dataGaLocation":2099},"why gitlab",[2159],{"title":2160,"links":2161},"Topics",[2162,2166,2171,2175,2180,2185,2190,2195],{"text":1679,"config":2163},{"href":2164,"dataGaName":2165,"dataGaLocation":2099},"/topics/ci-cd/","cicd",{"text":2167,"config":2168},"GitOps",{"href":2169,"dataGaName":2170,"dataGaLocation":2099},"/topics/gitops/","gitops",{"text":1676,"config":2172},{"href":2173,"dataGaName":2174,"dataGaLocation":2099},"/topics/devops/","devops",{"text":2176,"config":2177},"Version Control",{"href":2178,"dataGaName":2179,"dataGaLocation":2099},"/topics/version-control/","version control",{"text":2181,"config":2182},"DevSecOps",{"href":2183,"dataGaName":2184,"dataGaLocation":2099},"/topics/devsecops/","devsecops",{"text":2186,"config":2187},"Cloud Native",{"href":2188,"dataGaName":2189,"dataGaLocation":2099},"/topics/cloud-native/","cloud native",{"text":2191,"config":2192},"AI for Coding",{"href":2193,"dataGaName":2194,"dataGaLocation":2099},"/topics/devops/ai-for-coding/","ai for coding",{"text":2196,"config":2197},"Agentic AI",{"href":2198,"dataGaName":2199,"dataGaLocation":2099},"/topics/agentic-ai/","agentic ai",{"title":1750,"links":2201},[2202,2205,2208,2211,2214,2217,2219,2221,2223,2225,2227,2230,2232,2235,2239,2243],{"text":2203,"config":2204},"DevOps modernization",{"href":1765,"dataGaName":1766,"dataGaLocation":2099},{"text":2206,"config":2207},"Security modernization",{"href":1770,"dataGaName":1771,"dataGaLocation":2099},{"text":2209,"config":2210},"AI modernization",{"href":1775,"dataGaName":1776,"dataGaLocation":2099},{"text":2212,"config":2213},"Financial services",{"href":1801,"dataGaName":1802,"dataGaLocation":2099},{"text":2215,"config":2216},"Public sector",{"href":1806,"dataGaName":1807,"dataGaLocation":2099},{"text":1809,"config":2218},{"href":1811,"dataGaName":1812,"dataGaLocation":2099},{"text":1814,"config":2220},{"href":1816,"dataGaName":1817,"dataGaLocation":2099},{"text":1819,"config":2222},{"href":1821,"dataGaName":1822,"dataGaLocation":2099},{"text":1824,"config":2224},{"href":1826,"dataGaName":1827,"dataGaLocation":2099},{"text":1781,"config":2226},{"href":1783,"dataGaName":1784,"dataGaLocation":2099},{"text":2228,"config":2229},"Small business",{"href":1788,"dataGaName":1789,"dataGaLocation":2099},{"text":1791,"config":2231},{"href":1793,"dataGaName":1794,"dataGaLocation":2099},{"text":2167,"config":2233},{"href":2234,"dataGaName":2170,"dataGaLocation":2099},"/solutions/gitops/",{"text":2236,"config":2237},"Software composition analysis",{"href":1718,"dataGaName":2238,"dataGaLocation":2099},"software composition analysis",{"text":2240,"config":2241},"Value stream management",{"href":1736,"dataGaName":2242,"dataGaLocation":2099},"value stream management",{"text":2244,"config":2245},"All solutions",{"href":1757,"dataGaName":2246,"dataGaLocation":2099},"all solutions",{"title":1842,"links":2248},[2249,2254,2259,2261,2263,2265,2267,2269,2271,2273,2275,2277,2279,2281,2284],{"text":2250,"config":2251},"Install",{"href":2252,"dataGaName":2253,"dataGaLocation":2099},"/install/","install",{"text":2255,"config":2256},"Quick start guides",{"href":2257,"dataGaName":2258,"dataGaLocation":2099},"/get-started/","quick setup checklists",{"text":1855,"config":2260},{"href":1857,"dataGaName":181,"dataGaLocation":2099},{"text":1859,"config":2262},{"href":1861,"dataGaName":1862,"dataGaLocation":2099},{"text":1864,"config":2264},{"href":1866,"dataGaName":1867,"dataGaLocation":2099},{"text":1869,"config":2266},{"href":1871,"dataGaName":1872,"dataGaLocation":2099},{"text":1874,"config":2268},{"href":1876,"dataGaName":1877,"dataGaLocation":2099},{"text":1887,"config":2270},{"href":1889,"dataGaName":1890,"dataGaLocation":2099},{"text":1892,"config":2272},{"href":1894,"dataGaName":1895,"dataGaLocation":2099},{"text":1897,"config":2274},{"href":1899,"dataGaName":1900,"dataGaLocation":2099},{"text":1902,"config":2276},{"href":1904,"dataGaName":1905,"dataGaLocation":2099},{"text":1907,"config":2278},{"href":1909,"dataGaName":1910,"dataGaLocation":2099},{"text":1970,"config":2280},{"href":1972,"dataGaName":1973,"dataGaLocation":2099},{"text":2282,"config":2283},"What's new",{"href":1918,"dataGaName":1919,"dataGaLocation":2099},{"text":2285,"config":2286},"All resources",{"href":1849,"dataGaName":2287,"dataGaLocation":2099},"all resources",{"title":1921,"links":2289},[2290,2292,2294,2296,2298,2300,2302,2304,2306,2310,2315],{"text":1929,"config":2291},{"href":1931,"dataGaName":1923,"dataGaLocation":2099},{"text":1934,"config":2293},{"href":1936,"dataGaName":1937,"dataGaLocation":2099},{"text":1940,"config":2295},{"href":1942,"dataGaName":1943,"dataGaLocation":2099},{"text":1945,"config":2297},{"href":1947,"dataGaName":1948,"dataGaLocation":2099},{"text":1950,"config":2299},{"href":1952,"dataGaName":1953,"dataGaLocation":2099},{"text":1955,"config":2301},{"href":1957,"dataGaName":1958,"dataGaLocation":2099},{"text":1960,"config":2303},{"href":1962,"dataGaName":1963,"dataGaLocation":2099},{"text":1965,"config":2305},{"href":1967,"dataGaName":1968,"dataGaLocation":2099},{"text":2307,"config":2308},"Sustainability",{"href":2309,"dataGaName":2307,"dataGaLocation":2099},"/sustainability/",{"text":2311,"config":2312},"Diversity, inclusion and belonging (DIB)",{"href":2313,"dataGaName":2314,"dataGaLocation":2099},"/diversity-inclusion-belonging/","Diversity, inclusion and belonging",{"text":2316,"config":2317},"Modern Slavery Transparency Statement",{"href":2318,"dataGaName":2319,"dataGaLocation":2099},"https://handbook.gitlab.com/handbook/legal/modern-slavery-act-transparency-statement/","modern slavery transparency statement",{"items":2321},[2322,2325,2328],{"text":2323,"config":2324},"Terms",{"href":2129,"dataGaName":2130,"dataGaLocation":2099},{"text":2326,"config":2327},"Cookies",{"dataGaName":2139,"dataGaLocation":2099,"id":2140,"isOneTrustButton":714},{"text":434,"config":2329},{"href":2134,"dataGaName":2135,"dataGaLocation":2099},[2331],{"id":2332,"title":7,"body":1592,"config":2333,"content":2335,"description":1592,"extension":2339,"meta":2340,"navigation":714,"path":2341,"seo":2342,"stem":2343,"__hash__":2344},"blogAuthors/en-us/blog/authors/marcia-ramos.yml",{"template":2334},"BlogAuthor",{"name":7,"config":2336},{"headshot":2337,"ctfId":2338},"https://res.cloudinary.com/about-gitlab-com/image/upload/v1749659488/Blog/Author%20Headshots/gitlab-logo-extra-whitespace.png","Marcia-Ramos","yml",{},"/en-us/blog/authors/marcia-ramos",{},"en-us/blog/authors/marcia-ramos","UrFu-iLS1mEkxVCheaz27cAjfZXeLI9U1n5dGSOHXY4",[2346,2354,2362],{"title":2347,"description":2348,"heroImage":2349,"category":1588,"date":2350,"authors":2351,"slug":2353,"externalUrl":1592},"Two front doors: Module-level access in a Django GRC app","A technical deep-dive on restructuring a Django internal tool to support two distinct GitLab teams: Security Compliance and Internal Audit.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1750097663/Blog/Hero%20Images/Blog/Hero%20Images/Workflow%201800x945_2gQoQIbY9NvjLFpXtsxtXy_1750097663612.png","2026-10-05",[2352],"Donovan Felton","module-level-access-in-a-django-grc-app",{"title":2355,"description":2356,"heroImage":2357,"category":1588,"date":2358,"authors":2359,"slug":2361,"externalUrl":1592},"How GitLab reduced code-per-agentic-flow ratio by 45%","Learn how Flow Registry, a component-based framework that compiles YAML configurations into fully functional LangGraph flows, helped improve scalability and more.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1774465167/n5hlvrsrheadeccyr1oz.png","2026-09-22",[2360],"Mikolaj Wawrzyniak","how-gitlab-reduced-code-per-agentic-flow-ratio",{"title":2363,"description":2364,"heroImage":2365,"category":1588,"date":2366,"authors":2367,"slug":2369,"externalUrl":1592},"Co-Create: Building GitLab with our users","How GitLab users collaborated with us to build practical product improvements in the first half of 2026.","https://res.cloudinary.com/about-gitlab-com/image/upload/v1750099203/Blog/Hero%20Images/Blog/Hero%20Images/blog-image-template-1800x945%20%2820%29_2bJGC5ZP3WheoqzlLT05C5_1750099203484.png","2026-09-10",[2368],"Isa Huerga","co-create-h1-2026",{"header":2371,"text":2372,"button":2376,"disclaimer":2379},"Start your free\n\n30-day GitLab trial\n",[2373,2374,2375],"GitLab Duo Agent Platform access","Try our most advanced features","Automate complex tasks with AI",{"text":1649,"config":2377},{"href":2378,"dataGaName":1652,"dataGaLocation":1890},"https://gitlab.com/-/trials/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/blog/","No credit card required.",{"header":2381,"blurb":2382,"button":2383,"secondaryButton":2388},"Start building faster today","See what your team can do with the intelligent orchestration platform for DevSecOps.\n",{"text":2384,"config":2385},"Get your free trial",{"href":2386,"dataGaName":1652,"dataGaLocation":2387},"https://gitlab.com/-/trial_registrations/new?glm_content=default-saas-trial&glm_source=about.gitlab.com/","feature",{"text":2115,"config":2389},{"href":1984,"dataGaName":1657,"dataGaLocation":2387},1794911778163]