Docker

For quick familiarization with the application or testing, you can use the ready-made Docker Compose project.

First run

Install Docker, e.g. for Windows here

Clone all 3 ARCLib repositories into the desired folder:

git clone https://github.com/LIBCAS/ARCLib.git
git clone https://github.com/LIBCAS/ARCLib-Archival-Storage.git
git clone https://github.com/LIBCAS/ARCLib-frontend.git

Enter the ARCLib folder and start the Docker containers:

cd ARCLib
docker-compose build --no-cache
docker-compose up -d

It may happen that the arclib-be starts faster then the initialization code in the solr container and shuts down. In this case, just wait a while and start the arclib-be container again:

docker-compose start arclib-be

• The sample data and format library are automatically imported into the system at first launch.
• The status of the import can be monitored in the log of the arclib-be container.
• Importing the format library can take tens of minutes, so we recommend not deleting the Solr volume afterwards.
• After the import is complete, the ARCLib UI is available at: http://localhost:8000 , username: admin, password: admin
• After logging in, you can try ingest according to the instructions here without having to manually import any other data.
• Debug mode on the sample Producer Profile is by default turned off in Docker so the data of successful ingests is therefore written to the Archival Storage container.

More information

Docker in this project is for quick testing/getting familiar with the system, not for production use.

Applications running in the container are not automatically maintained, e.g. to update ClamAV it is necessary to manually run freshclam in the container, or rebuild the arclib-be container (build includes freshclam).

ClamAV Antivirus may need more than 2GB of memory allocated to the arclib-be container to run. If ClamAV fails during ingest for no apparent reason, try increasing the memory value in the arclib-be section of the docker-compose.yml