# Setup

## Install

### Requirements

- Docker
_Currently hosted on an ubuntu lxc container with docker and portainer [+ information](setup-lxc.md)._
- On instructions replace githost with host ip or address

### Services (Stacks)

If portainer installed use portainer (http://githost:9000) to setup/manage services

Required environment variables (.env):

```bash
GITEA_APP_VOLUMES_DATA_NAME=gitea_app_data
GITEA_DB_VOLUMES_DATA_NAME=gitea_db_data
GITEA_DB_VOLUMES_DB-DUMPS_NAME=gitea_db-dumps
GITEA_NETWORK_DEFAULT_NAME=gitea_default
DB_NAME=??
DB_USER=??
DB_PASSWORD=??
DB_ROOT_PASSWORD=??
HTTP_PORT=???
```

#### Gitea

   _[Docker Compose File](../docker/gitea-docker-compose.yaml)_

#### Duplicati

   _[Docker Compose File](../docker/dupliticati-docker-compose.yaml)_

After starting stack:

- Access duplicati (http://ipaddress:8200) and set a password

##### Requirements

- Duplicati Container with mySql client
  - [Dockerfile](htpp://missinggiturl)
  - [Git](https://git.limbosolutions.com/kb/duplicati)

## Restore

### Requirements

- Host setup with docker and portainer [+ information](setup.md)

### Process

1) Recreate stack gitea  _[Docker Compose](../docker/docker-compose.yaml)_ removing read only restrictions on duplicati volumes
1) Check every Container is ok and running
1) Stop every Container except duplicati and portainer
   _note: restore of portainer/duplicati not tested_
1) Enter Duplicati (http://githost:8200)
1) Import Backup job (if not possible next steps must be adapted)
   - Restore with permissions checked
   - All Imported jobs schedules must be disabled (or disable write permissions on backup host)
   - (step not required after this migration) Remove references to scripts (example:run-script-before-required, /data/myScripts/backupdb.sh)
1) Recreate duplicati local database (home-> backup-> advanced-> database-> Recreate (delete and repair))
1) Restore all files to original location
   - If database engine is diferent do not restore db_data and check restore database **before next steps**
   - From duplicati only restore custom scripts (duplicati-data/myScripts), dot not restore full duplicati with this processs because duplicati is running!
1) Recreate stack gitea  _[Docker Compose](../docker/docker-compose.yaml)_ with original read only restrictions on duplicati volumes
1) Confirm everything is ok and running
1) Return to duplicati on schedule job add script to run-script-before-required /data/myScripts/backupdb.sh
1) Execute a backup
1) Reenable Scheduling

### Database

Only required if database data files not recovarable. (Example: diferent database engine from backup)

1) Start Portainer container (if stopped in restore process)
2) Start Database container (if stopped in restore process)
3) Enter Database container bash (by using portainer)
4) Execute:

```bash
#select a file to import
ls /db-dumps
#select a file to import
DB_FILE= "file name to import"
# 
mysql --host db -uroot -p ${MYSQL_DATABASE} < /db-dumps/$DB_FILE
#enter root password (root password is in enviromnent variable ${MYSQL_ROOT_PASSWORD})
```