Gitea docker (rootless) without SSH Passthrough

README.md

Gitea docker (rootless) without SSH passthrough

Official gitea docs are heavily focussed on doing SSH passthrough from the host machine to the docker container. An alternative is to simply run SSH for Gitea on a different port. Though I had some problems getting this docker compose setup to run. This gist contains my setup I finally came up with: It does not require SSH passthrough from the host to the docker container but still offers support to git clone via SSH.

To check if this setup works for you simply follow these steps:

1. Place enclosed docker-compose.yml in a directory.
2. Run docker compose up
3. Visit http://localhost:8033/ and simply install Gitea with given defaults
4. Visit http://localhost:8033/user/sign_up and create user account with username example
5. Visit http://localhost:8033/user/settings/keys and add your SSH key
6. Visit http://localhost:8033/repo/create and create repository with test name
7. Clone repository using ssh://git@localhost:8034/example/test.git
8. In the previous step you should be authenticated automatically with your SSH key and get a clone of the empy git repository
9. Use this working setup as a base to customize for your needs.

References

• https://docs.gitea.com/installation/install-with-docker-rootless
• go-gitea/gitea#25479
• https://discord.com/channels/322538954119184384/345384901144477698/1121636052579401761
• go-gitea/gitea#25218 (comment)

docker-compose.yml

version: "3"

services:
  server:
    image: gitea/gitea:1.21.0-rootless
    container_name: gitea
    environment:
      - GITEA__server__START_SSH_SERVER=true
      - GITEA__server__SSH_PORT=8034
      - GITEA__server__ROOT_URL=http://localhost:8033/
    restart: unless-stopped
    volumes:
      - gitea-data:/var/lib/gitea
      - gitea-config:/etc/gitea
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "8033:3000" # webinterface
      - "8034:2222" # ssh

volumes:
  gitea-data:
  gitea-config: