Edit history

[LIST=1]
[*]If you havn't already done so, download the program "[URL='https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html']PuTTY[/URL]".


[*]Connect to your root server or VPS/vServer via SSH using [URL='https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html']PuTTY[/URL]. To do this, open [URL='https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html']PuTTY[/URL] and enter the domain or IP address of your server in the text box named "Host Name (or IP address)". Then click the "OK" button below.


[*]Update your package lists with the command [COLOR=rgb(184, 49, 47)][U][B]apt update[/B][/U][/COLOR]


[*]Now install any available updates of the packages already installed on your server using the command [COLOR=rgb(184, 49, 47)][U][B]apt upgrade -y[/B][/U][/COLOR]


[*]Next, install the packages needed for future installations in this tutorial by executing the following command: [COLOR=rgb(184, 49, 47)][U][B]apt install curl nano -y[/B][/U][/COLOR]


[*]If you want to use your own mail server to send e-mails (e.g. for user account activations), then I recommend the [URL='https://www.bennetrichter.de/anleitungen/mailcow-dockerized/']Mailcow mail server[/URL]. I've also published a [URL='https://www.bennetrichter.de/anleitungen/mailcow-dockerized/']tutorial[/URL] for this. Alternatively, you can also use Postfix, but Mailcow is recommended. However, if you want to install Postfix, use the command [COLOR=rgb(184, 49, 47)][B][U]apt install postfix -y[/U][/B][/COLOR] select "[B]internet site[/B]" during the installation and enter your domain as the "[B]system e-mail name[/B]". If you want to use an [B]external SMTP server[/B] (Gmail, Mailgun etc.) or [B]Mailcow[/B] to send e-mails from GitLab, then skip this step and continue with [B]step 10[/B] of this tutorial after you've installed GitLab (SMTP configuration).


[*]Add the repository needed to install GitLab by executing the command [COLOR=rgb(184, 49, 47)][B][U]curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | bash[/U][/B][/COLOR]


[*]Now update your package lists again with the command [COLOR=rgb(184, 49, 47)][B][U]apt update[/U][/B][/COLOR]


[*]Install GitLab and other required packages with the following command: [COLOR=rgb(184, 49, 47)][B][U]EXTERNAL_URL="http://gitlab.domain.com" apt install gitlab-ee -y[/U][/B][/COLOR] Replace "[B]http://gitlab.domain.com[/B]" with the URL, that you want to use to access the GitLab web interface. [B]Note[/B]: The default web server port 80 will be used. If a web server like [URL='https://www.bennetrichter.de/en/tutorials/apache2-php7-mariadb-phpmyadmin/']Apache2[/URL] is already installed, then you have to choose a different port. In this case, just enter the desired port behind the URL (e.g. "[B]http://gitlab.domain.com:8888[/B]" for port [B]8888[/B]).


[*][B]Optional[/B](if you want to use Mailcow or an external SMTP server to send e-mails) :
[LIST=1]
[*]Open the GitLab configuration file by executing the command [COLOR=rgb(184, 49, 47)][B][U]nano /etc/gitlab/gitlab.rb[/U][/B][/COLOR]


[*]Go to the SMTP configuration section starting at [B]line 80[/B] of this file and remove the "#" characters on the beginning of [B]lines 80 to 89[/B]. Then customize the SMTP configuration to match the SMTP server you want to use. You can find some information, including the SMTP configuration for Mailcow, [URL='https://docs.gitlab.com/omnibus/settings/smtp.html']here[/URL].


[*]Save your changes to the configuration by pressing [B]CTRL + X, then hit the "Y" key followed by enter[/B].


[*]Now you have to regenerate the GitLab configuration. To do this, enter the command [COLOR=rgb(184, 49, 47)][U][B]gitlab-ctl reconfigure[/B][/U][/COLOR] and restart GitLab by using the command [COLOR=rgb(184, 49, 47)][B][U]gitlab-ctl restart[/U][/B][/COLOR]

[/LIST]
[*]Next, open the GitLab web interface in your browser under the URL you set during the installation and set a password for the administrator user. The username for this user is "[B]root[/B]" by default.


[*]Now you can login with the username "[B]root[/B]" and the password you just set to configure and use GitLab.


[*]You can find several configuration parameters in the file "[B]/etc/gitlab/gitlab.rb[/B]". For example, to change the URL of your GitLab installation, enter the command [COLOR=rgb(184, 49, 47)][B][U]nano /etc/gitlab/gitlab.rb[/U][/B][/COLOR] to open this file and change the value of the parameter "[B]EXTERNAL_URL[/B]" in line 32. Save your changes to the configuration by pressing [B]CTRL + X, then hit the "Y" key followed by enter[/B] and regenerate the GitLab configuration using the command [COLOR=rgb(184, 49, 47)][B][U]gitlab-ctl reconfigure[/U][/B][/COLOR] After you've done this, GitLab needs to be restarted. Use the command gitlab-ctl restart to do this.
[/LIST]

Top Bottom

Search

Search

Edit history