https://github.com/aiidateam/aiida-prerequisites
Docker image that contains all prerequisites allowing to run AiiDA.
https://github.com/aiidateam/aiida-prerequisites
Last synced: about 2 months ago
JSON representation
Docker image that contains all prerequisites allowing to run AiiDA.
- Host: GitHub
- URL: https://github.com/aiidateam/aiida-prerequisites
- Owner: aiidateam
- Created: 2020-01-22T13:22:59.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2023-06-19T14:05:04.000Z (almost 2 years ago)
- Last Synced: 2025-04-13T04:06:21.939Z (about 2 months ago)
- Language: Shell
- Size: 112 KB
- Stars: 2
- Watchers: 4
- Forks: 2
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AiiDA Prerequisites
This repository adds
[PostgreSQL](https://www.postgresql.org/) and [RabbitMQ](https://www.rabbitmq.com/) servers on top of [phusion base image](https://github.com/phusion/baseimage-docker). Additionally, it creates a system profile ready to setup AiiDA under it.
# Docker image
The docker image:
* Is based on [phusion base image](https://github.com/phusion/baseimage-docker).
* Installs and launches [PostgreSQL](https://www.postgresql.org/) for $SYSTEM_USER.
* Installs and launches [RabbitMQ](https://www.rabbitmq.com/).
* Configures Linux environment for $SYSTEM_USER.
## Wait for services
The image provides a mechanism to wait until the startup script has *launched* all services.
Example of usage:
```
$ docker exec --tty $DOCKERID wait-for-services
```
This command will exit when all startup scripts are done.
Note, however, that the mechanism does not check that all services are actually running.
## Docker ARGs
The the following arguments can be set during *build* time:
```
ARG NB_USER="aiida"
ARG NB_UID="1000"
ARG NB_GID="1000"
```
These define the default user name, user id and group id for containers launched from the image.
To modify their value do the following:
```
$ docker build --build-arg NB_UID=200
```
## Docker ENVs
The following environment variables can be set during container *startup*:
```
ENV SYSTEM_USER ${NB_USER}
ENV SYSTEM_USER_UID ${NB_UID}
ENV SYSTEM_USER_GID ${NB_GID}
```
To modify their value do the following:
```
docker run -e SYSTEM_USER=aiida2
```
# Docker Hub repository
The docker image is built automatically on Docker Hub once new changes are pushed to the `master` or `develop` branches of this repository.
The `master` branch is available under the docker tag `stable`, while the `develop` branch is available under the docker tag `latest`.
In addition, any git tag pushed to the repository (say v1.0.1) will trigger a build on Docker Hub with the same docker tag without 'v' prefix (1.0.1).
All the images are available following this link: https://hub.docker.com/r/aiidateam/aiida-prerequisites
# Acknowledgements
This work is supported by the [MARVEL National Centre of Competence in Research]()
funded by the [Swiss National Science Foundation](), as well as by the [MaX
European Centre of Excellence]() funded by the Horizon 2020 EINFRA-5 program,
Grant No. 676598.
