gitlab-org--gitlab-foss/doc
Lin Jen-Shin 663593e87e Merge remote-tracking branch 'upstream/master' into no-ivar-in-modules
* upstream/master: (126 commits)
  Update VERSION to 10.3.0-pre
  Update CHANGELOG.md for 10.2.0
  default fill color for SVGs
  ignore hashed repos (for now) when using `rake gitlab:cleanup:repos`
  Use Redis cache for branch existence checks
  Update CONTRIBUTING.md: Link definition of done to criteria
  Use `make install` for Gitaly setups in non-test environments
  FileUploader should check for hashed_storage?(:attachments) to use disk_path
  Set the default gitlab-shell timeout to 3 hours
  Update composite pipelines index to include "id"
  Use arrays in Pipeline#latest_builds_with_artifacts
  Fix blank states using old css
  Skip confirmation user api
  Custom issue tracker
  Revert "check for `read_only?` first before seeing if request is disallowed"
  add `#with_metadata` scope to remove a N+1 from the notes' API
  Fix promoting milestone updating all issuables without milestone
  Batchload blobs for diff generation
  check for `read_only?` first before seeing if request is disallowed
  use `Gitlab::Routing.url_helpers` instead of `Rails.application.routes.url_helpers`
  ...
2017-11-22 17:07:01 +08:00
..
administration Document how to troubleshoot internal API calls 2017-11-18 00:06:15 -08:00
api Skip confirmation user api 2017-11-21 15:47:58 +00:00
articles fix date 2017-08-31 16:12:48 -03:00
ci Update pipeline status badge details docs 2017-11-20 12:29:11 +01:00
container_registry
customization Add username parameter to gravatar URL 2017-06-01 10:07:24 -05:00
development Merge remote-tracking branch 'upstream/master' into no-ivar-in-modules 2017-11-22 17:07:01 +08:00
downgrade_ee_to_ce Backports for ee-2112 2017-07-06 16:25:03 +08:00
gitlab-basics Exclude comments from specific docs 2017-11-01 15:56:40 +00:00
hooks
incoming_email
install Merge branch 'req-docs' into 'master' 2017-11-20 18:02:38 +00:00
integration Custom issue tracker 2017-11-21 15:21:50 +00:00
intro Exclude comments from specific docs 2017-11-01 15:56:40 +00:00
legal Merge branch 'jlh-replace-cla' into 'master' 2017-11-01 18:10:15 +00:00
logs
markdown
migrate_ci_to_ce Exclude comments from specific docs 2017-11-01 15:56:40 +00:00
monitoring
operations
pages
permissions
policy Improve the maintenance policy page 2017-10-31 17:05:06 +01:00
profile Docs new topic: "user/profile/index" 2017-07-27 19:23:35 +00:00
project_services
public_access
raketasks Improve GitLab Import rake task to work with Hashed Storage and Subgroups 2017-11-07 19:11:42 +00:00
security Exclude comments from specific docs 2017-11-01 15:56:40 +00:00
ssh Exclude comments from specific docs 2017-11-01 15:56:40 +00:00
system_hooks Add system hooks user_rename and group_rename 2017-11-03 11:26:52 +00:00
topics Replace 'charts' with 'chart' 2017-11-15 05:56:53 +08:00
university add glossary part 2 2017-11-07 15:44:49 +00:00
update Add Update guide for 10.2 2017-11-10 16:54:00 +00:00
user Custom issue tracker 2017-11-21 15:21:50 +00:00
web_hooks
workflow Exclude comments from specific docs 2017-11-01 15:56:40 +00:00
README.md Rewrite the GitHub importer from scratch 2017-11-07 23:24:59 +01:00

toc comments
false false

GitLab Documentation

Welcome to GitLab, a Git-based fully featured platform for software development!

GitLab offers the most scalable Git-based fully integrated platform for software development, with flexible products and subscription plans:

  • GitLab Community Edition (CE) is an opensource product, self-hosted, free to use. Every feature available in GitLab CE is also available on GitLab Enterprise Edition (Starter and Premium) and GitLab.com.
  • GitLab Enterprise Edition (EE) is an opencore product, self-hosted, fully featured solution of GitLab, available under distinct subscriptions: GitLab Enterprise Edition Starter (EES) and GitLab Enterprise Edition Premium (EEP).
  • GitLab.com: SaaS GitLab solution, with free and paid subscriptions. GitLab.com is hosted by GitLab, Inc., and administrated by GitLab (users don't have access to admin settings).

GitLab EE contains all features available in GitLab CE, plus premium features available in each version: Enterprise Edition Starter (EES) and Enterprise Edition Premium (EEP). Everything available in EES is also available in EEP.


Shortcuts to GitLab's most visited docs:

GitLab CI/CD Other
Quick start guide API
Configuring .gitlab-ci.yml SSH authentication
Using Docker images GitLab Pages

Getting started with GitLab

User account

  • User account: Manage your account
    • Authentication: Account security with two-factor authentication, setup your ssh keys and deploy keys for secure access to your projects.
    • Profile settings: Manage your profile settings, two factor authentication and more.
  • User permissions: Learn what each role in a project (external/guest/reporter/developer/master/owner) can do.

Projects and groups

Repository

Manage your repositories from the UI (user interface):

Issues and Merge Requests (MRs)

Git and GitLab

  • Git: Getting started with Git, branching strategies, Git LFS, advanced use.
  • Git cheatsheet: Download a PDF describing the most used Git operations.
  • GitLab Flow: explore the best of Git with the GitLab Flow strategy.

Migrate and import your projects from other platforms

Continuous Integration, Delivery, and Deployment

  • GitLab CI: Explore the features and capabilities of Continuous Integration, Continuous Delivery, and Continuous Deployment with GitLab.
    • Auto Deploy: Configure GitLab CI for the deployment of your application.
    • Review Apps: Preview changes to your app right from a merge request.
  • GitLab Cycle Analytics: Cycle Analytics measures the time it takes to go from an idea to production for each project you have.
  • GitLab Container Registry: Learn how to use GitLab's built-in Container Registry.

Automation

  • API: Automate GitLab via a simple and powerful API.
  • GitLab Webhooks: Let GitLab notify you when new code has been pushed to your project.

Integrations

  • Project Services: Integrate a project with external services, such as CI and chat.
  • GitLab Integration: Integrate with multiple third-party services with GitLab to allow external issue trackers and external authentication.
  • Trello Power-Up: Integrate with GitLab's Trello Power-Up

Administrator documentation

Learn how to administer your GitLab instance. Regular users don't have access to GitLab administration tools and settings.

Install, update, upgrade, migrate

  • Install: Requirements, directory structures and installation from source.
  • Mattermost: Integrate Mattermost with your GitLab installation.
  • Migrate GitLab CI to CE/EE: If you have an old GitLab installation (older than 8.0), follow this guide to migrate your existing GitLab CI data to GitLab CE/EE.
  • Restart GitLab: Learn how to restart GitLab and its components.
  • Update: Update guides to upgrade your installation.

User permissions

Features

Integrations

  • Integrations: How to integrate with systems such as JIRA, Redmine, Twitter.
  • Mattermost: Set up GitLab with Mattermost.

Monitoring

Performance

Customization

Admin tools

  • Gitaly: Configuring Gitaly, GitLab's Git repository storage service
  • 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.
  • Security: Learn what you can do to further secure your GitLab instance.
  • System hooks: Notifications when users, projects and keys are changed.

Troubleshooting

Contributor documentation