Quick Start Guide - comixed/comixed GitHub Wiki

Overview

This page is to help you go from 0 to running the ComiXed application on your system.

Setting Up Your System

A Note On Java Requirements

As of v0.7, ComiXed requires Java 11 or later, and will not run with any version prior to that. Since Oracle no longer ships a JRE (Java Runtime Environment) for Java after 9, you'll need to download a Java Development Kit (JDK) from here.

The Launch Directory.

To run the application, simply download and extract the comixed-app-*.zip release file. Inside of it you'll find a directory structure like the following:

comixed-release-1.0.0-2
comixed-release-1.0.0-2/bin
comixed-release-1.0.0-2/lib

To run the application use the following command line, use one of the following options from the bin directory. So, after extracting the contents of the distribution archive, do one of the following:

Linux Or Mac

 $ sh ./run.sh

Windows

 C:\users\comixed> run.bat

Database Location

By default, the application uses an embedded database, to manage your comics. The database uses files that are kept in the following directory, depending on what type of computer you're using:

  • c:/users/[your name]/.comixed [on Windows]
  • /home/[your name]/.comixed [on Linux, *nix]
  • /Users/[your name]/.comixed [on Mac OS X]

It is strongly recommended that you regularly backup these files, especially before running a new version of the application.

Logging In And Configuring Your Account

When run for the first time, ComiXed creates two default accounts for logging into the system:

  1. Username: comixedadmin@localhost Password: comixedadmin
  2. Username: comixedreader@localhost Password: comixedreader

It is highly recommended that you change at least the passwords for these accounts.

To log into the system as the user comixedadmin@localhost, open your web browser and go to http://localhost:7171 and log in.

Once logged in, click on the Account link at the top of the page. This will take you to the account page. You can then change your password, and your login name.

Once you've done this, you'll need to log back into the application using that new name and password.