How to set up Gitea on Nethserver with LDAP integration

Howto
1

I was looking around for some guides on how to do this and it seems there are no pre-made modules. I don’t like installing directly into neth, so I did the container approach like I’ve done with Jitsi before. Also, this is probably closer to what we’ll start seeing with Neth 8.

The usual steps:

  • Create an application directory: /opt/gitea
  • Create a data directory for the container to use: /opt/gitea/gitea-data
  • Make a docker compose file: /opt/gitea/docker-compose.yaml 
version: "3"

services:
  server:
    image: gitea/gitea:latest
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: unless-stopped
    volumes:
      - /opt/gitea/gitea-data:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "8001:3000"
      - "22222:22"
  • Add a sub-domain, point it to your server
  • Request a new cert with the new sub-domain
    • if using Let’s Encrypt it’s under System > Certificates
  • Add a reverse proxy (Applications > Web Server > Reverse Proxy)
    image
    image605×790 34.7 KB
  • run docker-compose up -d in the gitea directory
  • Join the container to the aqua network: docker network connect aqua gitea
  • Log in at https://git.mydomain.com and set your instance up
  • Make a local admin account so you can enable the LDAP auth method
  • Fill in LDAP information:
    image
    image1150×687 26 KB

    image
    image1142×455 28.9 KB
  • Sign in with your LDAP credentials
  • Enjoy!
3 Likes
2

Thanks for the howto.

@mark_nl created a module some time ago but of course the docker version is more current:

2 Likes
3

Thanks. Yes, I did see this one but it was a bit old and I wasn’t able to find it in the package repo. After reading that page again I can see it is because I don’t have the nethforge-testing repo enabled.

1 Like
4

@mark_nl Mind blessing us with a Nethserver 8 App?

Everything that was in NS7, should be in NS8(my mantra)

1 Like