Running with Docker¶

Prerequisites¶

You will need to have Docker installed. See https://docs.docker.com/install/.

You will also need a copy of the works database (library.sqlite).

Getting the TextCritical Docker image running¶

Step 1: Download TextCritical code¶

Download a zip file of the project from https://github.com/LukeMurphey/textcritical_net. You can do this by the "Clone or download" button and selecting "Download ZIP".

Unzip the downloaded file into a directory.

Step 2: Put a copy of the database in the var directory of the source-code¶

Obtain a copy of the library of works (library.sqlite) and place it in the /var directory of the source-code (i.e. textcritical_net-master/var/library.sqlite). You can use the library of works attached to this wiki entry to get started quickly (although it only includes on work).

Step 3: Build the docker image¶

Run the following from the directory where you unzipped the source code. This needs to be the same directory with the file with the name "Dockerfile":

docker build -t textcritical .

Step 4: Start the docker image¶

Start the docker image with the following command:

docker run -p 8080:8080 textcritical

You should now be able to access TextCritical on port 8080 on your localhost (e.g. http://localhost:8080).

The instance is setup with a default login name of "admin" and a password of "changeme". You can log into the administration system at the URL "admin" (e.g. http://localhost:8080/admin/)