1
0
mirror of https://github.com/tiyn/wiki.git synced 2025-04-19 22:17:45 +02:00

Compare commits

..

2 Commits

Author SHA1 Message Date
4185d96ec6 gramps: added entry and docker 2023-08-13 02:54:22 +02:00
a0dcd3130a shell: added renaming in bulk 2023-08-11 02:15:34 +02:00
3 changed files with 125 additions and 0 deletions

View File

@ -0,0 +1,112 @@
# gramps-project - gramps
This is a [Docker](/wiki/docker.md) container for a [Gramps](../gramps.md)
server.
The Server consists of 2 Docker containers, one is the gramps main server and one a redis instance.
The main server is split into two subcontainers.
In addition to the main container you need to connect a [redis container](./redis.md) to it.
## Set-up
Create the files `rebuild.sh` and `docker-compose.yml` at the same place.
Change the settings according to your needs and run `./rebuild.sh` afterwards.
## Environment-variables
Set the following environment-variables in the `environment:` section of the
docker-compose file.
| Name | Usage | Default |
| ----------------------------------------- | ------------------------------------ | ------- |
| `GRAMPSWEB_TREE` | Will create a new tree if not exists | `` |
| `GRAMPSWEB_CELERY_CONFIG__broker_url` | Redis broker URL | `` |
| `GRAMPSWEB_CELERY_CONFIG__result_backend` | Redis backend URL | `` |
| `GRAMPSWEB_RATELIMIT_STORAGE_URI` | Storage URI | `` |
## Volumes
Set the following volumes in the `volumes:` section of the docker-compose file.
| Outside mount/volume name | Container mount | Description |
| ------------------------- | ------------------------ | --------------------------- |
| `gramps_users` | `/app/users` | storage for users |
| `gramps_index` | `/app/indexdir` | storage for search index |
| `gramps_thumb_cache` | `/app/thumbnail_cache` | storage for thumbnails |
| `gramps_cache` | `/app/cache` | storage for cache |
| `gramps_secret` | `/app/users` | storage for flask secret |
| `gramps_db` | `/root/.gramps/grampsdb` | Gramps database |
| `gramps_media` | `/app/media` | storage for media |
| `gramps_tmp` | `/tmp` | storage for temporary files |
## Ports
Set the following ports in the `ports:` section.
| Container Port | Recommended outside port | Protocol | Description |
| -------------- | ------------------------ | -------- | ----------- |
| `5000` | `80` | TCP | WebUI |
## rebuild.sh
```sh
#!/bin/sh
docker-compose down
docker pull ghcr.io/gramps-project/grampsweb:latest
docker pull redis:alpine
docker-compose up -d
```
## docker-compose.yml
```yml
version: "3"
services:
grampsweb: &grampsweb
image: ghcr.io/gramps-project/grampsweb:latest
restart: always
ports:
- "5051:5000" # host:docker
environment:
GRAMPSWEB_TREE: "Gramps Web" # will create a new tree if not exists
GRAMPSWEB_CELERY_CONFIG__broker_url: "redis://grampsweb_redis:6379/0"
GRAMPSWEB_CELERY_CONFIG__result_backend: "redis://grampsweb_redis:6379/0"
GRAMPSWEB_RATELIMIT_STORAGE_URI: redis://grampsweb_redis:6379/1
depends_on:
- grampsweb_redis
volumes:
- gramps_users:/app/users
- gramps_index:/app/indexdir
- gramps_thumb_cache:/app/thumbnail_cache
- gramps_cache:/app/cache
- gramps_secret:/app/secret
- gramps_db:/root/.gramps/grampsdb
- gramps_media:/app/media
- gramps_tmp:/tmp
grampsweb_celery:
<<: *grampsweb # YAML merge key copying the entire grampsweb service config
ports: []
container_name: grampsweb_celery
depends_on:
- grampsweb_redis
command: celery -A gramps_webapi.celery worker --loglevel=INFO
grampsweb_redis:
image: redis:alpine
container_name: grampsweb_redis
restart: always
volumes:
- redis:/data
volumes:
gramps_users:
gramps_index:
gramps_thumb_cache:
gramps_cache:
gramps_secret:
gramps_db:
gramps_media:
gramps_tmp:
redis:
```

8
wiki/gramps.md Normal file
View File

@ -0,0 +1,8 @@
# Gramps
[Gramps](https://github.com/gramps-project/gramps) is a genealogical program.
## Setup
The software can be setup via [Docker](/wiki/docker.md) with the
[gramps-project image](/wiki/docker/gramps-project_-_grampsweb.md).

View File

@ -52,6 +52,11 @@ For renaming many files in bulk the `qmv` to move or `qcp` or copy can be used.
Usually both of these commands are packaged withing the `renameutils` package. Usually both of these commands are packaged withing the `renameutils` package.
For more information visit the [renameutils website](https://www.nongnu.org/renameutils/). For more information visit the [renameutils website](https://www.nongnu.org/renameutils/).
Another option for bulk renaming is `vidir` which is part of the `moreutils` package for most
[distributions](/wiki/linux/linux.md#distributions).
vidir is able to create folders which qmv is not.
More information can be found on the [moreutils website](https://joeyh.name/code/moreutils/).
### Expansion ### Expansion
This section is based on the This section is based on the