# Gitea

- [Links](#links)
- [Backup And Restore](#backup-and-restore)
  - [Gitea dump from docker host](#gitea-dump-from-docker-host)
- [nginx](#nginx)
- [act runner](#act-runner)
  - [custom image - with ansible](#custom-image---with-ansible)
  - [Official Docker Image](#official-docker-image)
    - [Docker compose](#docker-compose)
- [Other References](#other-references)

## Links

- [Homepage](https://gitea.io/)
- [Documentation](https://docs.gitea.io)
- [API](https://try.gitea.io/api/swagger)
- [GitHub](https://github.com/go-gitea)

## Backup And Restore

_Source - https://docs.gitea.io/en-us/backup-and-restore/_

### Gitea dump from docker host

```bash
# exec          -> execute
# -u            -> container name
# -w            -> working directory on container 
# bash -c "x"   -> execute bash with command x

/usr/bin/docker exec -u git -w /tmp/backups gitea bash -c "/app/gitea/gitea dump"



#export to import to postgres (migrating from mysql to postgres)
sudo docker exec -u git -it -w /tmp gitea bash -c '/app/gitea/gitea dump -d postgres'

```

## nginx

```bash
    location / {
        proxy_pass http://git_limbosolutions_com-gitea:80;
        proxy_redirect off;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Protocol $scheme;
        proxy_set_header X-Url-Scheme $scheme;
    }
```

## act runner

### custom image - with ansible

[Docker Image](/kb/-/packages/container/gitea%2Fact-runner_ansible/0.2.11)

[Dockerfile](./docker/act-runner/ansible/Dockerfile)

### Official Docker Image


#### Docker compose

``` yaml
...
  gitea:
    image: gitea/gitea
    ...

  runner:
    image: gitea/act_runner
    restart: always
    depends_on:
      - gitea
    volumes:
      - ./data/act_runner:/data
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - GITEA_INSTANCE_URL=<instance url>
      # When using Docker Secrets, it's also possible to use
      # GITEA_RUNNER_REGISTRATION_TOKEN_FILE to pass the location.
      # The env var takes precedence.
      # Needed only for the first start.
      - GITEA_RUNNER_REGISTRATION_TOKEN=<registration token>
```

https://gitea.com/gitea/act_runner/src/branch/main/examples/docker-compose

## Other References

- [limbosolutions gitea hosting](https://git.limbosolutions.com) and [git repo](https://git.limbosolutions.com/limbosolutions.com/git.limbosolutions.com)