You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+29-34Lines changed: 29 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
-
[](http://microbadger.com/images/sameersbn/gitlab"Get your own image badge on microbadger.com")
*Please refer to [Available Configuration Parameters](#available-configuration-parameters) to understand `GITLAB_PORT` and other configuration options*
201
201
202
-
__NOTE__: Please allow a couple of minutes for the GitLab application to start.
202
+
**NOTE**: Please allow a couple of minutes for the GitLab application to start.
203
203
204
204
Point your browser to `http://localhost:10080` and set a password for the `root` user account.
205
205
@@ -213,7 +213,7 @@ You should now have the GitLab application up and ready for testing. If you want
213
213
214
214
GitLab is a code hosting software and as such you don't want to lose your code when the docker container is stopped/deleted. To avoid losing any data, you should mount a volume at,
215
215
216
-
*`/home/git/data`
216
+
-`/home/git/data`
217
217
218
218
*Note: that if you are using the `docker-compose` approach, you must "inpect" the volumes (```docker volume inpect```) to check the mounted path.*
Here the image will also automatically fetch the `DB_NAME`, `DB_USER` and `DB_PASS` variables from the postgresql container as they are specified in the `docker run` command for the postgresql container. This is made possible using the magic of docker links and works with the following images:
@@ -419,6 +419,7 @@ Access to the gitlab application can be secured using SSL so as to prevent unaut
419
419
Jump to the [Using HTTPS with a load balancer](#using-https-with-a-load-balancer) section if you are using a load balancer such as hipache, haproxy or nginx.
420
420
421
421
To secure your application via SSL you basically need two things:
422
+
422
423
-**Private key (.key)**
423
424
-**SSL certificate (.crt)**
424
425
@@ -470,7 +471,6 @@ In case use of docker-compose ...
470
471
471
472
look for "< user >_gitlab-data" and copy the "certs" directory into the "Mountpoint"
472
473
473
-
474
474
```bash
475
475
mkdir -p /srv/docker/gitlab/gitlab/certs
476
476
cp gitlab.key /srv/docker/gitlab/gitlab/certs/
@@ -593,7 +593,7 @@ Refer to the GitLab [documentation](http://doc.gitlab.com/ce/integration/omniaut
593
593
594
594
#### CAS3
595
595
596
-
To enable the CAS OmniAuth provider you must register your application with your CAS instance. This requires the service URL GitLab will supply to CAS. It should be something like: https://git.example.com:443/users/auth/cas3/callback?url. By default handling for SLO is enabled, you only need to configure CAS for backchannel logout.
596
+
To enable the CAS OmniAuth provider you must register your application with your CAS instance. This requires the service URL GitLab will supply to CAS. It should be something like: `https://git.example.com:443/users/auth/cas3/callback?url`. By default handling for SLO is enabled, you only need to configure CAS for backchannel logout.
597
597
598
598
For example, if your cas server url is `https://sso.example.com`, then adding `--env 'OAUTH_CAS3_SERVER=https://sso.example.com'` to the docker run command enables support for CAS3 OAuth. Please refer to [Available Configuration Parameters](#available-configuration-parameters) for additional CAS3 configuration parameters.
599
599
@@ -709,14 +709,14 @@ Gitlab pages access control requires additional configuration before activating
709
709
710
710
Gitab pages access control makes use of the Gitlab OAuth Module.
Note about the `Redirect URI`; this can be tricky to configure or figure out, What needs to be achieved is to following, the redirect URI needs to end up at the `gitlab-pages` daemon with the `/auth` endpoint.
722
722
@@ -741,7 +741,6 @@ Add to following environment variables to your Gitlab Container.
741
741
742
742
After you have enabled the gitlab pages access control. When you go to a project `General Settings` -> `Permissions` you can choose the pages persmission level for the project.
743
743
744
-
745
744
### External Issue Trackers
746
745
747
746
Since version `7.10.0` support for external issue trackers can be enabled in the "Service Templates" section of the settings panel.
@@ -777,12 +776,10 @@ These options should contain something like:
777
776
-`PIWIK_URL=piwik.example.org`
778
777
-`PIWIK_SITE_ID=42`
779
778
780
-
781
779
### Available Configuration Parameters
782
780
783
781
*Please refer the docker run command options for the `--env-file` flag where you can specify all required environment variables in a single file. This will save you from writing a potentially long docker run command. Alternatively you can use docker-compose. docker-compose users and Docker Swarm mode users can also use the [secrets and config file options](#docker-secrets-and-configs)*
784
782
785
-
786
783
Below is the complete list of available options that can be used to customize your gitlab installation.
787
784
788
785
#### `DEBUG`
@@ -2023,7 +2020,7 @@ GitHub App Client secret. No defaults.
2023
2020
2024
2021
#### `OAUTH_GITHUB_URL`
2025
2022
2026
-
Url to the GitHub Enterprise server. Defaults to https://github.com
2023
+
Url to the GitHub Enterprise server. Defaults to `https://github.com`
2027
2024
2028
2025
#### `OAUTH_GITHUB_VERIFY_SSL`
2029
2026
@@ -2047,7 +2044,7 @@ BitBucket App Client secret. No defaults.
2047
2044
2048
2045
#### `OAUTH_BITBUCKET_URL`
2049
2046
2050
-
Bitbucket URL. Defaults: https://bitbucket.org/
2047
+
Bitbucket URL. Defaults: `https://bitbucket.org/`
2051
2048
2052
2049
#### `OAUTH_SAML_ASSERTION_CONSUMER_SERVICE_URL`
2053
2050
@@ -2415,7 +2412,6 @@ docker-compose run --rm gitlab app:rake gitlab:backup:restore # List available b
2415
2412
docker-compose run --rm gitlab app:rake gitlab:backup:restore BACKUP=1515629493_2020_12_06_13.10.0 # Choose to restore from 1515629493
2416
2413
```
2417
2414
2418
-
2419
2415
## Host Key Backups (ssh)
2420
2416
2421
2417
SSH keys are not backed up in the normal gitlab backup process. You
For a complete list of available rake tasks please refer https://github.com/gitlabhq/gitlabhq/tree/master/doc/raketasks or the help section of your gitlab installation.
2476
+
For a complete list of available rake tasks please refer <https://github.com/gitlabhq/gitlabhq/tree/master/doc/raketasks> or the help section of your gitlab installation.
2481
2477
2482
2478
*P.S. Please avoid running the rake tasks for backup and restore operations on a running gitlab instance.*
2483
2479
@@ -2513,7 +2509,7 @@ Usage when using `docker-compose` can also be found there.
2513
2509
>
2514
2510
> Since GitLab release `8.6.0` PostgreSQL users should enable `pg_trgm` extension on the GitLab database. Refer to GitLab's [Postgresql Requirements](http://doc.gitlab.com/ce/install/requirements.html#postgresql-requirements) for more information
2515
2511
>
2516
-
> If you're using `sameersbn/postgresql` then please upgrade to `sameersbn/postgresql:12-20200524` or later and add `DB_EXTENSION=pg_trgm,btree_gist` to the environment of the PostgreSQL container (see: https://github.com/sameersbn/docker-gitlab/blob/master/docker-compose.yml#L8).
2512
+
> If you're using `sameersbn/postgresql` then please upgrade to `sameersbn/postgresql:12-20200524` or later and add `DB_EXTENSION=pg_trgm,btree_gist` to the environment of the PostgreSQL container (see: <https://github.com/sameersbn/docker-gitlab/blob/master/docker-compose.yml#L8>).
2517
2513
>
2518
2514
> As of version 13.7.0, the required PostgreSQL is version 12.x. If you're using PostgreSQL image other than the above, please review section [Upgrading PostgreSQL](#upgrading-postgresql).
2519
2515
@@ -2550,7 +2546,6 @@ Replace `x.x.x` with the version you are upgrading from. For example, if you are
2550
2546
-**Step 4**: Start the image
2551
2547
2552
2548
> **Note**: Since GitLab `8.0.0` you need to provide the `GITLAB_SECRETS_DB_KEY_BASE` parameter while starting the image.
2553
-
2554
2549
> **Note**: Since GitLab `8.11.0` you need to provide the `GITLAB_SECRETS_SECRET_KEY_BASE` and `GITLAB_SECRETS_OTP_KEY_BASE` parameters while starting the image. These should initially both have the same value as the contents of the `/home/git/data/.secret` file. See [Available Configuration Parameters](#available-configuration-parameters) for more information on these parameters.
0 commit comments