How to set up SSL certificates with sameersbn/docker-gitlab?

The README provides detailed steps for generating self-signed certificates or using CA-certified ones, including installing them in the certs directory and enabling HTTPS via environment variables like GITLAB_HTTPS and SSL_SELF_SIGNED. You'll need to copy key files and configure ports accordingly.

sameersbn/docker-gitlab vs official GitLab Docker image: which should I use?

Sameersbn/docker-gitlab offers more configuration flexibility and is based on the 'install from source' method, ideal for custom deployments. The official Omnibus Docker image is simpler and vendor-supported, better for standard setups or those needing guaranteed compatibility.

How do I backup and restore data in docker-gitlab?

Use the included backup tools by setting environment variables for automated backups, with support for remote storage like AWS S3. The Maintenance section explains commands for creating and restoring backups, ensuring data persistence across container restarts.

Can I use an external PostgreSQL database with this image?

Yes, the image supports external PostgreSQL servers by setting DB_HOST, DB_NAME, DB_USER, and DB_PASS environment variables. It also allows linking to PostgreSQL containers, with details in the Database configuration section.

What are the hardware requirements for running docker-gitlab?

The README specifies a minimum of 1GB RAM, referencing GitLab's hardware requirements. For production, more resources may be needed depending on user load and repository size, so plan accordingly based on GitLab's documentation.

How to configure OAuth providers like Google or GitHub?

Configure OAuth by setting environment variables such as OAUTH_GOOGLE_API_KEY and OAUTH_GOOGLE_APP_SECRET for each provider. The OmniAuth Integration section lists supported providers and the required parameters for authentication setup.

Gitlab

MITShell18.11.1

A Dockerized GitLab CE image for self-hosted source code management and DevOps lifecycle.

Visit Website

What is Gitlab?

sameersbn/docker-gitlab is a Docker image that packages GitLab Community Edition for easy deployment and self-hosting. It provides a complete, containerized GitLab instance with source code management, CI/CD, issue tracking, and DevOps tools. The image simplifies installation, configuration, and maintenance, allowing teams to run GitLab on their own infrastructure without the complexity of manual setup.

Target Audience

Development teams, DevOps engineers, and organizations that want to self-host GitLab for source code management, CI/CD pipelines, and project collaboration. It is particularly useful for those familiar with Docker who prefer containerized deployments over traditional installations.

Value Proposition

It offers a production-ready, Dockerized GitLab CE image with extensive configuration options, external service support, and built-in tools for backups, SSL, and authentication. Unlike the official GitLab Omnibus Docker image, this project provides an alternative based on the "install from source" method, giving users more control and flexibility in their deployment.

Overview

Dockerized GitLab

Use Cases

Best For

Self-hosting GitLab CE for private code repositories

Related Projects

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

GitHub

8.1k stars2.2k forks0 contributors

Setting up a containerized DevOps platform with CI/CD

Deploying GitLab on Docker or Docker Swarm

Integrating GitLab with external PostgreSQL and Redis services

Configuring GitLab with custom SSL certificates and OAuth providers

Running GitLab in environments where the official Omnibus package is not preferred

Not Ideal For

Teams seeking a fully managed, cloud-hosted GitLab instance with automatic updates and support
Organizations requiring official vendor support and certification for compliance or enterprise use
Small projects or individual developers wanting a simple, out-of-the-box Git solution with minimal configuration
Environments where Docker or container orchestration is not already in use, preferring traditional package managers

Pros & Cons

Pros

Extensive Configuration Flexibility

The image supports a wide range of environment variables for customizing databases, Redis, SSL, OAuth providers, and more, as detailed in the Configuration section, allowing tailored deployments.

Production-Ready Features

Includes built-in tools for backups, SSL/TLS setup with HSTS, health checks, and integration with external services like AWS S3 and Google Cloud Storage, ensuring reliability for self-hosted setups.

Docker and Compose Support

Provides a docker-compose.yml file and step-by-step Docker run commands for quick deployment, simplifying the initial launch and management in containerized environments.

Active Community Maintenance

The project has a changelog, multiple contributors, and an issue tracker, indicating ongoing development and community support for updates and bug fixes.

Cons

Complex Initial Setup

Requires generating multiple random secret keys (e.g., for DB, OTP, encryption) and configuring numerous environment variables, which can be error-prone and time-consuming for newcomers.

Dependency on External Services

For production use, it relies on external PostgreSQL and Redis servers or containers, adding infrastructure complexity and potential points of failure compared to all-in-one solutions.

Potential Upgrade Hassles

Upgrading PostgreSQL versions may require manual data migration, as noted in the README, and GitLab version updates could introduce breaking changes that need careful handling.

Frequently Asked Questions

Home

Robotic Tooling

Gogs

Gogs is a painless self-hosted Git service

A platform for community discussion. Free, open, simple.

Mattermost is an open source platform for secure collaboration across the entire software development lifecycle..

Jitsi Meet - Secure, Simple and Scalable Video Conferences that you use as a standalone app or embed in your web application.