Difference between revisions of "Installing EPrints using Docker"

From EPrints Documentation
Jump to: navigation, search
(Updated Docker instructions)
Line 1: Line 1:
Simple EPrints 3.4 docker setup.
+
== Simple EPrints 3.4 Docker Setup ==
 +
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.
  
- Justin Bradley, July 2019
+
Download either [EPrints 3.4.1 https://files.eprints.org/2416/] or {EPrints 3.4 GitHub HEAD https://files.eprints.org/2454/] 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).
  
Sets up two containers, one for the database, the second for httpd and eprints.
+
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.
  
Needs Docker and Docker Compose, if you install Docker Desktop you get both of these.
+
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
  
Edit docker-compose.yml and set EPRINTS_HOSTNAME to the name of your host machine, localhost is the default and fine if running locally.
+
=== 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
  
Disable any services binding to port 80, ie apache httpd.
+
=== Known Issues ===
 
+
* EPrints' indexer may not start automatically.
EPrints publications installation will be available via http://yourhost once set up.
+
* [[Installing_EPrints_on_RHEL/Fedora/CentOS#Non-critical_Dependencies|Some additional perl modules]] may be required for some import/export plugins.
 
 
User: admin
 
 
 
Password: admin123
 
 
 
 
 
build and start
 
 
 
$ docker-compose up --build -d
 
 
 
normal start
 
 
 
$ docker-compose up -d
 
 
 
shut down
 
 
 
$ docker-compose down
 
 
 
 
 
There are a few issues.
 
 
 
- The indexer often fails to start automatically.
 
 
 
- Some additional perl modules may be required for some import/export libraries.
 

Revision as of 08:52, 29 April 2021

Simple EPrints 3.4 Docker Setup

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 https://files.eprints.org/2416/] or {EPrints 3.4 GitHub HEAD https://files.eprints.org/2454/] 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).

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