Difference between revisions of "Installing EPrints using Docker"
(Updated Docker instructions) |
(Added to Howto category.) |
||
| (4 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | |||
You will need both Docker and Docker Compose to make use of EPrints' Docker configurations, if you install [https://www.docker.com/products/docker-desktop Docker Desktop] you get both of these. | You will need both Docker and Docker Compose to make use of EPrints' Docker configurations, if you install [https://www.docker.com/products/docker-desktop Docker Desktop] you get both of these. | ||
| − | Download either [ | + | Download either [https://files.eprints.org/2416/ EPrints 3.4.1 ] or [https://files.eprints.org/2454/ EPrints 3.4 GitHub HEAD] Docker configuration tarball from https://files.eprints.org. |
| − | Either of Docker configurations will set up two containers, one for EPrints' database (MySQL) and the other for EPrints' webserver (Apache). | + | Either of these Docker configurations will set up two containers, one for EPrints' database (MySQL) and the other for EPrints' webserver (Apache). |
| − | Edit docker-compose.yml and set ''EPRINTS_HOSTNAME'' to the name of your host machine, localhost is the default and fine if you end to access this EPrints instance locally. | + | Edit ''docker-compose.yml'' and set ''EPRINTS_HOSTNAME'' to the name of your host machine, localhost is the default and fine if you end to access this EPrints instance locally. |
Disable any services on your computer that may be binding to TCP port 80, as this will be needed by EPrints' webserver Docker container. | Disable any services on your computer that may be binding to TCP port 80, as this will be needed by EPrints' webserver Docker container. | ||
| Line 14: | Line 13: | ||
Password: admin123 | Password: admin123 | ||
| − | + | == Useful Commands == | |
* To build and start | * To build and start | ||
$ docker-compose up --build -d | $ docker-compose up --build -d | ||
| Line 22: | Line 21: | ||
$ docker-compose down | $ docker-compose down | ||
| − | + | == Known Issues == | |
* EPrints' indexer may not start automatically. | * EPrints' indexer may not start automatically. | ||
* [[Installing_EPrints_on_RHEL/Fedora/CentOS#Non-critical_Dependencies|Some additional perl modules]] may be required for some import/export plugins. | * [[Installing_EPrints_on_RHEL/Fedora/CentOS#Non-critical_Dependencies|Some additional perl modules]] may be required for some import/export plugins. | ||
| + | |||
| + | [[Category:Howto]] | ||
Latest revision as of 10:26, 11 January 2022
You will need both Docker and Docker Compose to make use of EPrints' Docker configurations, if you install Docker Desktop you get both of these.
Download either EPrints 3.4.1 or EPrints 3.4 GitHub HEAD Docker configuration tarball from https://files.eprints.org.
Either of these Docker configurations will set up two containers, one for EPrints' database (MySQL) and the other for EPrints' webserver (Apache).
Edit docker-compose.yml and set EPRINTS_HOSTNAME to the name of your host machine, localhost is the default and fine if you end to access this EPrints instance locally.
Disable any services on your computer that may be binding to TCP port 80, as this will be needed by EPrints' webserver Docker container.
An EPrints publications installation will be available via http://yourhost once set up. You can login to this using the following credentials:
User: admin Password: admin123
Useful Commands
- To build and start
$ docker-compose up --build -d
- For a normal start (i.e. when the containers have been previously built)
$ docker-compose up -d
- To shut down
$ docker-compose down
Known Issues
- EPrints' indexer may not start automatically.
- Some additional perl modules may be required for some import/export plugins.
