GitLab One-Click Application

Version control is an essential system that helps software developers collaborate on projects, keep track of source changes, and maintain a clean code repository. GitLab is an open-source, Git-based repository management server that hosts Git repos and sets up control structures within a clean web interface.

The DigitalOcean GitLab One-Click application deploys GitLab on a DigitalOcean Droplet using the project’s Omnibus installer. You can have a repository system configured and running in minutes.

Components

Droplets created using this One-Click have the following software components:

Component Version
Linux Ubuntu 18.04.1
GitLab CE Latest GitLab Omnibus package
Postfix Latest from APT

In addition to the package installation, the One-Click also:

  • Enables the UFW firewall to allow only SSH (port 22, rate limited), HTTP (port 80), and HTTPS (port 443) access.

Quickstart

GitLab One-Click Droplets require a minimum of 2 CPU cores and 4GB of RAM, so the first available plan begins at 4GB by default. Because it’s easier to increase the size of a Droplet if you’re not sure what you’ll need, it’s easiest to start with the default and resize the Droplet later if it is warranted.

After the GitLab Droplet is created, you need to connect to it via SSH to complete the setup. Make sure to substitute the Droplet’s IP address.

ssh root@use_your_droplet_ip

Once you connect, you’ll be prompted to configure GitLab with an interactive shell prompt.

GitLab is not configured. If you would like customize it yourself,
press 'n' now.

Okay to Configure GitLab (Y|n):

Press ENTER or push Y to begin.

Next, you’ll be prompted for the external URL. You can accept the IP address as the default or specify a domain name. If you specify a domain name with https and it resolves to the Droplet IP, the script will generate a Let’s Encrypt certificate for free and configure the site to use it:

External URL (defaults to http://203.0.113.11):

Once you’ve entered a domain or accepted the IP address, press ENTER.

You’ll be asked to set the root user’s password and then the configuration script will run. Note that the password must be at least 8 characters and requires a special character and number.

External URL (defaults to http://203.0.113.11):
Running 'gitlab-ctl reconfigure', this will take a minute...

Depending on the Droplet’s resources, it may take several minutes before you see additional output. The following output confirms that the installation is complete.

Setting the password...
  wrote log to /var/log/gitlab_set_pass.log
-----------------------------------------------------------------------------

You can access GitLab via:
    Web URL:  http://203.0.113.11
    User:     root
    Password: your_password
For more information about this 1-Click, see: http://do.co/gitlabapp

Happy Coding!
-----------------------------------------------------------------------------

Visit the URL displayed in the output after you’ve configured the site. You’ll arrive on the Sign in page. Enter the user and password that you chose when you configured the site, which are displayed in the confirmation text.

DigitalOcean GitLab log in

You now have a full GitLab server configured and at your disposal to manage repositories:

DigitalOcean GitLab landing page

Next Steps

For further information on configuring your GitLab Omnibus installation, check out the official GitLab documentation. A few specific recommendations:

  • Configure system email addresses. The GitLab One-Click application is configured to use a local Postfix server for sending email. For a production site, we recommend using an external service such as Mandrill or SendGrid. Learn how to customize the system From: address and the Support From: address and other mail settings on GitLab’s SMTP Settings page.

  • Set up HTTPS. We strongly recommend following GitLab’s instructions on SSL and other security customizations for Nginx.

  • Update to newer releases. Use the GitLab Community Edition directions to update to newer releases.