How to set up Gitea on Nethserver with LDAP integration

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"

    image: gitea/gitea:latest
    container_name: gitea
      - USER_UID=1000
      - USER_GID=1000
    restart: unless-stopped
      - /opt/gitea/gitea-data:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
      - "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)
  • run docker-compose up -d in the gitea directory
  • Join the container to the aqua network: docker network connect aqua gitea
  • Log in at and set your instance up
  • Make a local admin account so you can enable the LDAP auth method
  • Fill in LDAP information:

  • Sign in with your LDAP credentials
  • Enjoy!

Thanks for the howto.

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


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

@mark_nl Mind blessing us with a Nethserver 8 App?

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

1 Like