gitlab-org--gitlab-foss/doc/README.md

GitLab Community Edition

All technical content published by GitLab lives in the documentation, including:

• General Documentation
  • User docs: general documentation dedicated to regular users of GitLab
  • Admin docs: general documentation dedicated to administrators of GitLab instances
  • Contributor docs: general documentation on how to develop and contribute to GitLab
• Topics: pages organized per topic, gathering all the resources already published by GitLab related to a specific subject, including general docs, technical articles, blog posts and video tutorials.
• GitLab University: guides to learn Git and GitLab through courses and videos.

User documentation

• Account Security Securing your account via two-factor authentication, etc.
• API Automate GitLab via a simple and powerful API.
• CI/CD GitLab Continuous Integration (CI) and Continuous Delivery (CD) getting started, .gitlab-ci.yml options, and examples.
• Container Registry Learn how to use GitLab Container Registry.
• Git Attributes Managing Git attributes using a .gitattributes file.
• Git cheatsheet Download a PDF describing the most used Git operations.
• GitLab as OAuth2 authentication service provider. It allows you to login to other applications from GitLab.
• GitLab basics Find step by step how to start working on your commandline and on GitLab.
• GitLab Pages Using GitLab Pages.
• Importing and exporting projects between instances.
• Importing to GitLab Import your projects from GitHub, Bitbucket, GitLab.com, FogBugz and SVN into GitLab.
• Markdown GitLab's advanced formatting system.
• Migrating from SVN Convert a SVN repository to Git and GitLab.
• Permissions Learn what each role in a project (external/guest/reporter/developer/master/owner) can do.
• Profile Settings
• Project Services Integrate a project with external services, such as CI and chat.
• Public access Learn how you can allow public and internal access to projects.
• Search through GitLab: Search for issues, merge requests, projects, groups, todos, and issues in Issue Boards.
• Snippets Snippets allow you to create little bits of code.
• SSH Setup your ssh keys and deploy keys for secure access to your projects.
• Webhooks Let GitLab notify you when new code has been pushed to your project.
• Workflow Using GitLab functionality and importing projects from GitHub and SVN.

Administrator documentation

• Access restrictions Define which Git access protocols can be used to talk to GitLab
• Authentication/Authorization Configure external authentication with LDAP, SAML, CAS and additional Omniauth providers.
• Container Registry Configure Docker Registry with GitLab.
• Custom Git hooks Custom Git hooks (on the filesystem) for when webhooks aren't enough.
• Debugging Tips Tips to debug problems when things go wrong
• Environment Variables to configure GitLab.
• Git LFS configuration
• GitLab Pages configuration Configure GitLab Pages.
• GitLab performance monitoring with InfluxDB Configure GitLab and InfluxDB for measuring performance metrics.
• GitLab performance monitoring with Prometheus Configure GitLab and Prometheus for measuring performance metrics.
• Header logo Change the logo on the overall page and email header.
• High Availability Configure multiple servers for scaling or high availability.
• Housekeeping Keep your Git repository tidy and fast.
• Install Requirements, directory structures and installation from source.
• Integration How to integrate with systems such as JIRA, Redmine, Twitter.
• Issue closing pattern Customize how to close an issue from commit messages.
• Koding Set up Koding to use with GitLab.
• Libravatar Use Libravatar instead of Gravatar for user avatars.
• Log system Log system.
• Migrate GitLab CI to CE/EE Follow this guide to migrate your existing GitLab CI data to GitLab CE/EE.
• Monitoring uptime Check the server status using the health check endpoint.
• Operations Keeping GitLab up and running.
• Raketasks Backups, maintenance, automatic webhook setup and the importing of projects.
• Reply by email Allow users to comment on issues and merge requests by replying to notification emails.
• Repository checks Periodic Git repository checks.
• Repository storage paths Manage the paths used to store repositories.
• Request Profiling Get a detailed profile on slow requests.
• Restart GitLab Learn how to restart GitLab and its components.
• Security Learn what you can do to further secure your GitLab instance.
• Sidekiq Troubleshooting Debug when Sidekiq appears hung and is not processing jobs.
• System hooks Notifications when users, projects and keys are changed.
• Update Update guides to upgrade your installation.
• Web terminals Provide terminal access to environments from within GitLab.
• Welcome message Add a custom welcome message to the sign-in page.

Contributor documentation

• Development All styleguides and explanations how to contribute.
• Legal Contributor license agreements.