How to install GarageHQ on Fedora CoreOS

GarageHQ is a self-hosted web application for managing your garage inventory, developed by the Deux Fleurs team. In this tutorial, we will guide you through the steps to install GarageHQ on Fedora CoreOS.

Prerequisites

Before starting the installation process, make sure you have the following prerequisites:

• A virtual or physical machine running the latest version of Fedora CoreOS.
• A valid user account with administrative privileges on the system.
• A stable and reliable internet connection.

Step 1: Install Docker

GarageHQ is a Docker-based application, so it requires Docker to be installed on your system. Follow the steps below to install Docker on Fedora CoreOS:

sudo systemctl enable docker
sudo systemctl start docker

Step 2: Configure Docker

Next, create a new Docker configuration file to specify the location of the Docker data directory, where GarageHQ will store its data.

sudo nano /etc/systemd/system/docker.service.d/override.conf

Add the following lines to the file:

[Service]
ExecStart=
ExecStart=/usr/bin/dockerd -g /var/lib/docker

Save the changes and close the editor.

Restart the Docker service to apply the new configuration:

sudo systemctl daemon-reload
sudo systemctl restart docker

Step 3: Install GarageHQ

Now that Docker is set up, you are ready to install GarageHQ. Use the following command to pull the latest version of the GarageHQ Docker image from the registry:

sudo docker pull deuxfleurs/garagehq

Step 4: Configure GarageHQ

To configure GarageHQ, create a new directory to store the application's configuration files, and then create a new configuration file called config.json inside the directory.

sudo mkdir /etc/garagehq
sudo nano /etc/garagehq/config.json

Add the following content to the config.json file:

{
   "dataFolder": "/var/lib/garagehq",
   "port": 3000,
   "smtp": {
      "service": "Gmail",
      "auth": {
         "user": "[email protected]",
         "pass": "your-email-password"
      }
   }
}

Replace the example Gmail credentials with your own credentials. Save the changes and close the editor.

Step 5: Launch GarageHQ

Finally, launch the GarageHQ container using the following command:

sudo docker run -d \
   --name garagehq \
   -p 3000:3000 \
   -v /etc/garagehq:/app/config \
   -v /var/lib/garagehq:/app/data \
   deuxfleurs/garagehq

This command will start the GarageHQ container in detached mode, map the application's port to port 3000 on the host system, and mount the two volumes containing the configuration and data respectively.

Step 6: Access GarageHQ

Now that GarageHQ is up and running, you can access it by opening your web browser and entering the following URL in the address bar:

http://localhost:3000

You should see the login page for GarageHQ. Use the default administrator account with the following credentials:

Email: [email protected]
Password: admin

You should change these credentials as soon as you have logged in for the first time.

Congratulations! You have successfully installed GarageHQ on Fedora CoreOS. You can now use it to manage your garage inventory.