Introduction

The Docker image hides away the code for ComiXed, allowing you to treat it like an appliance; i.e., when a new one comes out, you can just upgrade it in place and you're done. But the image doesn't hold your comics, it only holds the code to be run.

So when you're setting up your environment, the best practice is to pick a directory on your computer to be dedicated to your library.

Creating The Directories To Use

For this example we will use $HOME/Documents/comixed as the library's location. So we'll want to create the following directories:

• $HOME/Documents/comixed/library - this will hold the actual comic files,
• $HOME/Documents/comixed/database - this is where ComiXed will create it's database, and
• $HOME/Documents/comixed/library/incoming - this is where you will place comics to import into your library.

Launching The Docker Container

To create the container locally, use the following command line:

$ docker run -it -p 7171:7171/tcp -v $HOME/Documents/comixed/library:/library -v $HOME/Documents/comixed/database:/root/.comixed comixed/comixed:latest

You will find several new files in the database subdirectory. These are the files for the embedded database CX uses to manage your comics. It also contains the cache directory for images as well as other files.

Importing Comics Into The Library

To import new comics:

1. copy the files into the $HOME/Documents/comixed/library/incoming directory,
2. go to the Import Comics page in ComiXed, and
3. enter /library/incoming as the directory to search.

ComiXed will then load and return the new comics. You can then import those files and consolidate your library as normal.