summaryrefslogtreecommitdiff
path: root/doc/user/admin_area/custom_project_templates.md
blob: 02c2efaa4f39a8ac21b95d5a9402cf80541fd045 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
---
type: reference
---

# Custom instance-level project templates **(PREMIUM ONLY)**

> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/6860) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2.

GitLab administrators can configure the group where all the custom project
templates are sourced.

Every project directly under the group namespace will be
available to the user if they have access to them. For example:

- Public project in the group will be available to every logged in user.
- Private projects will be available only if the user is a member of the project.

Repository and database information that are copied over to each new project are
identical to the data exported with
[GitLab's Project Import/Export](../project/settings/import_export.md).

NOTE: **Note:**
To set project templates at a group level,
see [Custom group-level project templates](../group/custom_project_templates.md).

## Configuring

GitLab administrators can configure a GitLab group that serves as template
source for an entire GitLab instance by:

1. Navigating to **Admin area > Settings > Templates**.
1. Expanding **Custom project templates**.
1. Selecting a group to use.
1. Pressing **Save changes**.

NOTE: **Note:**
Projects below subgroups of the template group are **not** supported.

<!-- ## Troubleshooting

Include any troubleshooting steps that you can foresee. If you know beforehand what issues
one might have when setting this up, or when something is changed, or on upgrading, it's
important to describe those, too. Think of things that may go wrong and include them here.
This is important to minimize requests for support, and to avoid doc comments with
questions that you know someone might ask.

Each scenario can be a third-level heading, e.g. `### Getting error message X`.
If you have none to add when creating a doc, leave this section in place
but commented out to help encourage others to add to it in the future. -->