BigW Consortium Gitlab

public_access.md 1.89 KB
Newer Older
1 2
# Public access

3 4
GitLab allows you to change your projects' visibility in order be accessed
**publicly** or **internally**.
5

6 7 8
Projects with either of these visibility levels will be listed in the
public access directory (`/public` under your GitLab instance).
Here is the [GitLab.com example](https://gitlab.com/public).
9

10 11
Internal projects will only be available to authenticated users.

12 13 14
## Visibility of projects

### Public projects
15

16
Public projects can be cloned **without any** authentication.
17

18
They will also be listed on the public access directory (`/public`).
19

20 21
**Any logged in user** will have [Guest](../permissions/permissions)
permissions on the repository.
22

23
### Internal projects
24

25
Internal projects can be cloned by any logged in user.
26

27 28
They will also be listed on the public access directory (`/public`) for logged
in users.
29

30 31
Any logged in user will have [Guest](../permissions/permissions) permissions on
the repository.
32

33
### How to change project visibility
34

35 36
1. Go to your project's **Settings**
1. Change "Visibility Level" to either Public, Internal or Private
37 38

## Visibility of users
39

40 41 42 43 44
The public page of a user, located at `/u/username`, is always visible whether
you are logged in or not.

When visiting the public page of a user, you can only see the projects which
you are privileged to.
45

46
## Visibility of groups
47

48 49
The public page of a group, located at `/groups/groupname`, is always visible
to everyone.
50

51 52
Logged out users will be able to see the description and the avatar of the
group as well as all public projects belonging to that group.
53

54
## Restricting the use of public or internal projects
55

56 57 58 59
In the Admin area under **Settings** (`/admin/application_settings`), you can
restrict the use of visibility levels for users when they create a project or a
snippet. This is useful to prevent people exposing their repositories to public
by accident. The restricted visibility settings do not apply to admin users.