better documentation

Documentation/backup_and_restore.md

@@ -0,0 +1,38 @@
+# Backup & Restore
+
+## Requirements
+
+- Host setup with docker and portainer
+
+### Process
+
+1) Recreate gitea stack removing read only restrictions on duplicati volumes
+1) Check every Container is ok and running
+1) Stop every Container except duplicati
+1) Enter Duplicati
+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)
+1) Restore all files (except and duplicati data) to original location
+   - If database engine is diferent do not restore db_data and check restore database **before next steps**with this processs because duplicati is running!
+1) Recreate stack gitea with original read only restrictions on duplicati volumes
+1) Confirm everything is ok and running
+1) Execute a backup
+
+### Database
+
+Only required if not recovarable database data files. (Example: diferent database engine from backup)
+
+1) Start Database container
+2) Enter Database container bash (using portainer)
+3) 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})
+```

README.md

@@ -1,7 +1,22 @@
 # git.limbosolutions.com
  
- Welcome to the public repository of my Git Server https://git.limbosolutions.com
+ Welcome to public repository of my [Git Server](https://git.limbosolutions.com)
 
 ## Setup
 
-For more information about check [documentation](documentation/setup.md)
+Setup assumes no access to the host except through Portainer.
+
+This demonstrates that access to docker is the only real requirement to host git.limbosolutions.com
+
+_[Docker Compose File](../docker/docker-compose.yaml)_
+
+### Requirements
+
+- Docker
+_Currently hosted on an ubuntu lxc container with docker and portainer [+ information](https://git.limbosolutions.com/marcio.fernandes/wansrv01.dev.lan/src/branch/main/README.md)._
+
+- [Duplicati Image with mySql client](https://git.limbosolutions.com/kb/duplicati/src/branch/main/docker/mysqlclient/README.md)
+
+## Backup & Restore
+
+[More information](Documentation/backup_and_restore.md)