Product Solutions Resources Partners Pricing Support Talk to an expert Get free trial Login Websites for your GitLab projects, user account or group What is GitLab Pages? Create websites for your GitLab projects, groups, or user account. Use any static website generator: Jekyll, Middleman, Hexo, Hugo, Pelican, and more. Connect your custom domain(s) and TLS certificates. Host your static websites on GitLab.com for free, or on your own GitLab instance. Strategy Documentation [ STEP 01 ] Fork one of our example projects While you can create a project from scratch, let's keep it simple and fork one of your favorite example projects to get a quick start. GitLab Pages works with any static site generator. [ STEP 02 ] Enable shared Runners You can take advantage of the free shared Runners available on GitLab.com. All your builds will run on distinct Virtual Machines which use the latest Docker Engine. This will effectively eliminate any possible security issues, as there is no potential of breaking outside the container. However, you are free to set up your own Runner for your project. Navigate to your project's Settings > CI/CD and click on "Enable shared runners." This combines the power of GitLab CI/CD with GitLab Runner to deploy static sites based on any generator. On new projects this setting may be enabled by default. [ STEP 03 ] Configure your project (optional) If you skip this step, your website will be available at https://username.gitlab.io/projectname, where username is your username on GitLab and projectname is the name of the project you forked in the first step. This is what we call a project page. If you want the website to be available at https://username.gitlab.io, go to your project's Settings > Advanced, rename your project to username.gitlab.io and update its path to username.gitlab.io as shown at the screenshot. This is what we call a user page. Depending on the static generator this may require some additional steps. Make sure to read the README.md file of the project you chose. [ STEP 04 ] Manually run a pipeline Manually run a pipeline for the first time in order to trigger the job process. Alternatively, commit & push at least one change. You can edit your site files right from the browser, or use Git from the command line. Visit your project's Pipelines and click the Run pipeline button. In the next page hit Create pipeline and the pipeline will start. Once the pipeline runs, the build process will begin and your site will eventually be available online. [ STEP 05 ] Visit your site! Fire up your browser and visit https://username.gitlab.io/projectname or https://username.gitlab.io depending on what you followed in step 3. Learn more about GitLab Pages Read through this guide to create your project from scratch Use with any static website generator. Read our quick start tutorials or browse our documentation . Add multiple custom domains and secure them with your own TLS certificates . Create custom error pages. Try all GitLab features - free for 30 days GitLab is more than just source code management or CI/CD. It is a full software development lifecycle & DevOps tool in a single application. Try GitLab Free Twitter Facebook YouTube LinkedIn Why GitLab? Product Solutions Services DevOps tools Is it any good? Releases Pricing Get started Resources All resources All-Remote Blog Newsletter Events Webcasts Topics Training Docs Developer Portal Install Community Customers Contribute Community Programs Direction Technology Partners Channel Partners Open Source Partners GitLab for Open Source GitLab for Education GitLab for Startups Shop Community Forum Support Get help Contact Sales Contact Support Support options Status Customers Portal Company About What is GitLab? Jobs Culture Leadership Team Press Investor Relations Analysts Handbook Security Contact Terms Privacy Cookie Preferences Trademark Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license View page source — Edit in Web IDE — please contribute. © 2021 GitLab B.V. This website uses cookies We use cookies to make our websites and services operate correctly, to understand how visitors engage with us and to improve our product and marketing efforts. See our cookie policy for more information.Cookie Policy Cookies Settings Accept All Cookies