- \n
- Ubuntu 18.04<\/li>\n
- Root privileges<\/li>\n<\/ul>\n
What we will do?<\/h2>\n
- \n
- Install Docker-CE<\/li>\n
- Install Docker Compose<\/li>\n
- Deploy Gitea as Container using Docker<\/li>\n
- Gitea Post-Installation<\/li>\n
- Create First Repository<\/li>\n
- Testing First Commit<\/li>\n<\/ol>\n
Step 1 – Install Docker-CE<\/h2>\n
The first step we will do for this guide is to install the Docker community edition to the Ubuntu 18.04 server. We will install the Docker CE package from the official Docker repository.<\/p>\n
Add the Docker and Docker repository by running commands below.<\/p>\n
curl -fsSL https:\/\/download.docker.com\/linux\/ubuntu\/gpg | sudo apt-key add -![\"Add](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04.png\" "\\"\\"")
<\/a><\/p>\nThe ‘add-apt-repository’ command will automatically update the repository.<\/p>\n
Now install the Docker CE package.<\/p>\n
sudo apt policy docker-ce![\"install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-1.png\" "\\"\\"")
<\/a><\/p>\nWhen the installation is complete, start the docker service and enable it to launch everytime at system boot.<\/p>\n
sudo systemctl start dockerDocker CE is up and running on the Ubuntu 18.04 server. Verify the installation by checking the docker version.<\/p>\n
docker version<\/code><\/pre>\n![\"Check](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-2.png\" "\\"\\"")
<\/a><\/p>\nor run the docker ‘hello-world’.<\/p>\n
docker run hello-world<\/code><\/pre>\n![\"docker](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-3.png\" "\\"\\"")
<\/a><\/p>\nStep 2 – Install Docker Compose<\/h2>\n
Docker-Compose is a command line tool for defining and managing multi-container docker applications. It allows you to create a container as a service, great for your development, testing and staging environment.<\/p>\n
Install Docker Compose by downloading the binary file and make it an executable.<\/p>\n
sudo curl -L https:\/\/github.com\/docker\/compose\/releases\/download\/1.22.0\/docker-compose-$(uname -s)-$(uname -m) -o \/usr\/local\/bin\/docker-composeNow check the docker-compose command.<\/p>\n
docker-compose version<\/code><\/pre>\nDocker Compose is now installed.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-4.png\" "\\"\\"")
<\/a><\/p>\nStep 3 – Deploy Gitea as Docker Container<\/h2>\n
In this step, we will create a new docker-compose script that contains all services configuration including PostgreSQL Database and Traefik reverse proxy. We will set up all deployment files on the directory named ‘deployment’.<\/p>\n
Create Custom Docker Network<\/h3>\n
Before creating the deployment configuration, let’s create a new custom bridge network. It will be used for the external service traefik reverse proxy.<\/p>\n
Check the list docker network.<\/p>\n
docker network ls<\/code><\/pre>\nNow create a new custom bridge network named ‘hakasenet’.<\/p>\n
docker network create hakasenet<\/code><\/pre>\nCheck it again.<\/p>\n
docker network ls<\/code><\/pre>\nNow you will get ‘hakasenet’ network on the list.<\/p>\n
![\"Check](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-5.png\" "\\"\\"")
<\/a><\/p>\nSetup Deployment Directory and Files<\/h3>\n
Create a new directory named ‘deployment’ and the ‘docker-compose.yml’ script on it.<\/p>\n
mkdir deployment; cd deploymentNow create new directory ‘gitea’ and ‘postgres’ data volume.<\/p>\n
mkdir -p gitea\/ postgres\/<\/code><\/pre>\nCreate a new file ‘acme.json’ and change the permission of the file. it will be used to store Letsencrypt data.<\/p>\n
touch acme.jsonNow create the global traefik configuration ‘traefik.toml’ file.<\/p>\n
touch traefik.toml<\/code><\/pre>\nAnd below are files and directories we’ve for the Gitea installation using Docker.<\/p>\n
tree<\/code><\/pre>\n![\"Setup](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-6.png\" "\\"\\"")
<\/a><\/p>\nSetup PostgreSQL Service<\/h3>\n
The database service PostgreSQL is the first service that we want to configure. The database service will run only on the internal docker network.<\/p>\n
And we will be using the Postgres 9.6 image, using ‘gitea’ as database name, user, and password, and set up the postgres data volume.<\/p>\n
Edit the ‘docker-compose.yml’ file using vim<\/a>.<\/p>\n
vim docker-compose.yml<\/code><\/pre>\nPaste configurations below.<\/p>\n
version: \"3\" \n \nnetworks: hakasenet: external: true internal: external: false \n \nservices: db: image: postgres:9.6 restart: always environment: - POSTGRES_USER=gitea - POSTGRES_PASSWORD=gitea - POSTGRES_DB=gitea labels: - \"traefik.enable=false\" networks: - internal volumes: - .\/postgres:\/var\/lib\/postgresql\/data<\/pre>\n
Save and exit.<\/p>\n
Setup Traefik Reverse Proxy<\/h3>\n
Now we will configure the Traefik reverse proxy for our Gitea installation.<\/p>\n
The traefik service will be running under HTTP and HTTPS default ports, running on the custom bridge network named ‘hakasenet’, and we will configure it to use the Letsencrypt certificates that will be defined on the ‘traefik.toml’ file.<\/p>\n
Edit the compose script.<\/p>\n
vim docker-compose.yml<\/code><\/pre>\nPaste configurations under the db service configuration.<\/p>\n
traefik: image: traefik:latest command: --docker ports: - 80:80 - 443:443 labels: - \"traefik.enable=true\" - \"traefik.backend=dashboard\" - \"traefik.frontend.rule=Host:traefik.hakase-labs.io\" - \"traefik.port=8080\" networks: - hakasenet volumes: - \/var\/run\/docker.sock:\/var\/run\/docker.sock - .\/traefik.toml:\/traefik.toml - .\/acme.json:\/acme.json container_name: traefik restart: always<\/pre>\n
Save and exit.<\/p>\n
Now edit the ‘traefik.toml’ configuration file.<\/p>\n
vim traefik.toml<\/code><\/pre>\nAnd paste the following configuration.<\/p>\n
#Traefik Global Configuration \ndebug = false \ncheckNewVersion = true \nlogLevel = \"ERROR\" \n \n#Define the EntryPoint for HTTP and HTTPS \ndefaultEntryPoints = [\"https\",\"http\"] \n \n#Define the HTTP port 80 and \n#HTTPS port 443 EntryPoint \n#Enable automatically redirect HTTP to HTTPS \n[entryPoints] \n[entryPoints.http] \naddress = \":80\" \n[entryPoints.http.redirect] \nentryPoint = \"https\" \n[entryPoints.https] \naddress = \":443\" \n[entryPoints.https.tls] \n \n#Enable Traefik Dashboard on port 8080 \n#with basic authentication method \n#hakase and password \n[entryPoints.dash] \naddress=\":8080\" \n[entryPoints.dash.auth] \n[entryPoints.dash.auth.basic] users = [ \"hakase:$apr1$hEgpZUN2$OYG3KwpzI3T1FqIg9LIbi.\", ] \n \n[api] \nentrypoint=\"dash\" \ndashboard = true \n \n#Enable retry sending a request if the network error \n[retry] \n \n#Define Docker Backend Configuration \n[docker] \nendpoint = \"unix:\/\/\/var\/run\/docker.sock\" \ndomain = \"hakase-labs.io\" \nwatch = true \nexposedbydefault = false \n \n#Letsencrypt Registration \n#Define the Letsencrypt ACME HTTP challenge \n[acme] \nemail = \"[email\u00a0protected]<\/a>\" \nstorage = \"acme.json\" \nentryPoint = \"https\" \nOnHostRule = true [acme.httpChallenge] entryPoint = \"http\"<\/pre>\n
Save and exit.<\/p>\n
Note:<\/strong><\/p>\n
- \n
- Change the acme letsencrypt email with your valid email address.<\/li>\n<\/ul>\n
Setup Gitea Service<\/h3>\n
Edit the ‘docker-compose.yml’ configuration file.<\/p>\n
vim docker-compose.yml<\/code><\/pre>\nPaste the gitea service configuration at the bottom of the line.<\/p>\n
server: image: gitea\/gitea:latest environment: - USER_UID=1000 - USER_GID=1000 restart: always networks: - internal volumes: - .\/gitea:\/data ports: - \"3000\" - \"22\" labels: - \"traefik.enabled=true\" - \"traefik.backend=gitea\" - \"traefik.frontend.rule=Host:git.hakase-labs.io\" - \"traefik.docker.network=hakasenet\" - \"traefik.port=3000\" networks: - internal - hakasenet depends_on: - db - traefik<\/pre>\n
Save and exit.<\/p>\n
The Gitea service will be running on the TCP port ‘3000’, using those two docker networks ‘internal’ and ‘hakasenet’, and will run under the traefik reverse proxy on domain ‘git.hakase-labs.io’.<\/p>\n
Docker composes configuration for Gitea deployment has been completed.<\/p>\n
Deploy All Services<\/h3>\n
Now deploy the stack using ‘docker-compose’ command below.<\/p>\n
docker-compose up -d<\/code><\/pre>\nThe command will download all docker images needed and run services defined on the docker-compose script.<\/p>\n
![\"Deploy](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-7.png\" "\\"\\"")
<\/a><\/p>\nAnd when it’s complete, check available services on docker using ps option as below.<\/p>\n
docker-compose ps<\/code><\/pre>\nNow you will get the result as below.<\/p>\n
![\"docker-compose](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-8.png\" "\\"\\"")
<\/a><\/p>\nThe PostgreSQL database, Gitea, and traefik reverse proxy containers are now up and running. The database service is running on the default port ‘5432’, the gitea server is running on port ‘3000’, and the traefik proxy is running on HTTP and HTTPS ports, accessible from the outside network\/internet.<\/p>\n
If you want to check all logs from docker check, run command below.<\/p>\n
docker-compose logs<\/code><\/pre>\n![\"docker-compose](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-9.png\" "\\"\\"")
<\/a><\/p>\nStep 4 – Gitea Post-Installation<\/h2>\n
Open your web browser and type your Gitea URL installation. Mine is:<\/p>\n
https:\/\/git.hakase-labs.io\/<\/strong><\/em><\/p>\n
Now you will get the default Gitea page.<\/p>\n
![\"Gitea](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-10.png\" "\\"\\"")
<\/a><\/p>\nAdd the installation path to the URL.<\/p>\n
https:\/\/git.hakase-labs.io\/install<\/strong><\/em><\/p>\n
Now you will get the Gitea installation page.<\/p>\n
Database configuration<\/h3>\n
Type the PostgreSQL database details, and use ‘db<\/strong>‘ as a host.<\/p>\n
![\"Gitea](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-11.png\" "\\"\\"")
<\/a><\/p>\nGeneral Gitea Configuration<\/h3>\n
Change the ‘Site title’ with your own title, the ‘SSH Server Domain’ (without https) and ‘Gitea Base URL’ with your gitea server URL.<\/p>\n
![\"General](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-12.png\" "\\"\\"")
<\/a><\/p>\nAdmin Account Settings<\/h3>\n
On the admin settings, type the admin username, password, and email address.<\/p>\n
![\"Admin](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-13.png\" "\\"\\"")
<\/a><\/p>\nNow click ‘Install Gitea’ button.<\/p>\n
And you will be redirected to the Gitea default user dashboard.<\/p>\n
![\"Gitea](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-14.png\" "\\"\\"")
<\/a><\/p>\nStep 5 – Create First Repository in Gitea<\/h2>\n
On the user home page, click the ‘+’<\/strong> button.<\/p>\n
Now type details of the repository that you want to create.<\/p>\n
![\"Add](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-15.png\" "\\"\\"")
<\/a><\/p>\nand click the ‘Create Repository’ button.<\/p>\n
The repository has been created.<\/p>\n
![\"The](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-16.png\" "\\"\\"")
<\/a><\/p>\nStep 6 – Testing First Commit<\/h2>\n
Back to your terminal shell, and set up the default git user and email.<\/p>\n
Run git commands below.<\/p>\n
git config --global user.name \"hakase\"Now clone the repository.<\/p>\n
git clone https:\/\/git.hakase-labs.io\/hakase\/myrepo.git<\/code><\/pre>\nGo to the repository directory ‘myyrepo’ and edit the README.md file.<\/p>\n
cd myrepo\/make changes on the README file, then save and exit.<\/p>\n
Now commit the repository.<\/p>\n
git add .And push it to the server.<\/p>\n
git push origin master<\/code><\/pre>\nType your username and password.<\/p>\n
And following should be the result.<\/p>\n
![\"Test](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/12\/how-to-install-gitea-self-hosted-git-service-using-docker-on-ubuntu-18-04-17.png\" "\\"\\"")
<\/a><\/p>\nCheck to the repository page and make sure you get the changes as below.<\/p>\n
- Change the acme letsencrypt email with your valid email address.<\/li>\n<\/ul>\n
![\"Add](\"https:\/\/www.howtoforge.com\/images\/how_to_install_gitea_self_hosted_git_service_using_docker\/big\/1.png\" "\\"\\"")
<\/a><\/p>\n