Skip to content

getting_started.md

Latest commit

 

History

History
90 lines (78 loc) · 3.81 KB

getting_started.md

File metadata and controls

90 lines (78 loc) · 3.81 KB

Getting Started

This assumes you are running a modern Linux distro with Docker installed/configured and docker-compose installed. Some familiarity with Docker is assumed.

There are two paths to get started - one is to clone this repo and build the image yourself, the other is to leverage Docker Hub and creating the docker-compose.yml and supplemental files yourself.

Option 1: Clone and Build

  1. Clone the repo
  2. Build the docker image: docker build -t comicrack .
  3. Create an appropriate folder (outside the repo as to not confuse/anger the git gods). /opt/comicrack is a good choice and is assumed for the rest of this guide.
  4. Follow the steps for Option 2 below

Option 2: Docker Hub

  1. Create a docker-compose.yml file in an appropriate folder (this guide uses /opt/comicrack). See below for an example docker-compose.yml.

    NOTE: You'll want to update your comics directory and the PUID/PGID to reflect your user/group ID. You can find those IDs by running id in a terminal.

    version: "2.1"
services:
mariadb:
    image: lscr.io/linuxserver/mariadb:10.5.17
    container_name: mariadb
    environment:
    - PUID=1024
    - PGID=1000
    - TZ=Etc/UTC
    volumes:
    - /opt/comicrack/mariadb:/config
    expose:
    - "3306"
    restart: unless-stopped
    networks:
    - comicrack
comicrack:
    image: pezhore/comicrack:latest
    container_name: comicrack
    depends_on:
    - mariadb
    environment:
    - PUID=1024
    - PGID=1000
    - TZ=Etc/UTC
    volumes:
    - /opt/comicrack/local:/config/local
    - /opt/comicrack/roaming:/config/roaming
    - /path/to/comics:/config/comics
    ports:
    - 9001:3001
    networks:
    - comicrack
networks:
comicrack:
    name: comicrack

  2. Create the first run MariaDB folder /opt/comicrack/mariadb/initdb.d and copy the init_comicdb.sql file from the repo into it.

  3. Run docker-compose up -d to start the containers.

  4. Open a browser and navigate to https://<server ip>:9001 to access the web interface. NOTE: The first run may result in ComicRack coming up before MariaDB does its full initialization. If so, wait until the docker logs indicate MariaDB has finished its setup and then issue the docker-compose restart comicrack command.

Building From Scratch (Don't Do This)

I'll leave this here purely for historical purposes - or if you have some desire to build a fresh install of ComicRack yourself (or maybe you need some other abandonware wine app dockerized?). Briefly, the process is to create a Dockerfile with the base LinuxServer KasmVNC image, but run it first with the prefix folder mapped to your host. That way, when you run the container and manually setup Wine/your app, you capture all the prefix changes and can burn it into a new/final image.

The process is briefly:

  1. Remove the /root/config/.wine32 (or existing prefix), and change /root/defaults/autostart to just be xterm (this will let you interact with the terminal of your fresh image)

  2. Make a wine32 directory in the repo, then run docker mounting only the $(pwd)/wine32 to /config/.wine32 (or your desired prefix location in your container).

  3. In the web browser, browse to http://localhost:3001, manually run winetricks to download dotnet45, and then install comicrack itseslf. (this will populate your host's wine32 directory.

    NOTE: Make sure to cleanly exit the container when done.

  4. Move the $(pwd)/wine32 to $(pwd)/root/config/.wine32 (or your desired prefix location), edit the /root/defaults/autostart to have wine execute your binary, and build the container again.

  5. Run the container again, and verify it works as expected.