mirror of
				https://github.com/tiyn/wiki.git
				synced 2025-11-04 04:11:15 +01:00 
			
		
		
		
	Compare commits
	
		
			2 Commits
		
	
	
		
			8d60e297c1
			...
			4185d96ec6
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
| 4185d96ec6 | |||
| a0dcd3130a | 
							
								
								
									
										112
									
								
								wiki/docker/gramps-project_-_grampsweb.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										112
									
								
								wiki/docker/gramps-project_-_grampsweb.md
									
									
									
									
									
										Normal 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
									
								
							
							
						
						
									
										8
									
								
								wiki/gramps.md
									
									
									
									
									
										Normal 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).
 | 
				
			||||||
@@ -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
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user