Welcome to Developer Tools

This guide provides comprehensive information for developers setting up Tookit with Docker. Learn containerization best practices and deployment strategies.

Docker Installation → Docker Compose → Deployment Guide →

Docker Setup Guide

What is Docker?

Docker is a containerization platform that packages your application and all dependencies into a standardized unit called a container. This ensures your app runs the same way everywhere.

Installation Steps

Download Docker Desktop
Visit docker.com/products/docker-desktop
Run the Installer
Double-click the Docker Desktop Installer and follow the wizard
Enable WSL 2
If prompted, enable Windows Subsystem for Linux 2 (WSL 2) for better performance
Restart Your Computer
Some configurations may require a restart
Verify Installation
```
docker --version
docker run hello-world
```

Download Docker Desktop for Mac
Visit docker.com/products/docker-desktop
Open the DMG File
Drag the Docker icon to the Applications folder
Launch Docker
Open Applications folder and double-click Docker.app
Grant Permissions
Enter your Mac password when prompted
Verify Installation
```
docker --version
docker run hello-world
```

Update Package Manager
```
sudo apt-get update
```

Install Docker

sudo apt-get install docker.io docker-compose

Add User to Docker Group

sudo usermod -aG docker $USER
newgrp docker

Start Docker Service

sudo systemctl start docker
sudo systemctl enable docker

Verify Installation
```
docker --version
docker run hello-world
```

Essential Docker Commands

docker build -t image-name .

Build a Docker image from Dockerfile

docker run -p 8000:8000 image-name

Run a container from an image

docker ps

List running containers

docker logs container-id

View container logs

docker stop container-id

Stop a running container

docker rm container-id

Remove a container

Docker Compose Configuration

Understanding Docker Compose

Docker Compose allows you to define and run multi-container Docker applications using a YAML file. Perfect for orchestrating multiple services.

Tookit Docker Compose

Below is the Docker Compose configuration for Tookit:

version: '3.8'

services:
  toolshub:
    build: .
    container_name: toolshub-app
    ports:
      - "4002:10000"
    environment:
      - NODE_ENV=production
      - PORT=10000
    volumes:
      - ./uploads:/tmp/uploads
      - ./backend:/app/backend
      - ./frontend:/app/frontend
    restart: unless-stopped

volumes:
  uploads:
    driver: local

Key Configuration Explained

version

Specifies the Compose file version. 3.8 supports most Docker features

services

Defines containers that will run. Each service is a separate container

build

Path to Dockerfile. Docker will build an image from this

ports

Maps ports: "host_port:container_port". Maps 4002 on your machine to 10000 in container

environment

Sets environment variables inside the container

volumes

Mounts directories for persistent data and code updates

Docker Compose Commands

docker-compose up

Start services defined in docker-compose.yml

docker-compose up -d

Start services in detached mode (background)

docker-compose down

Stop and remove all services and volumes

docker-compose logs -f

View live logs from all services

docker-compose ps

List running services

docker-compose build

Build or rebuild services

Deployment Guide

Quick Start Deployment

1

Clone the Repository

git clone <repository-url>
cd Toolshub

2

Build the Docker Image

docker-compose build

3

Start the Services

docker-compose up -d

4

Access the Application

Open your browser and navigate to: http://localhost:4002

5

Check Logs

docker-compose logs -f

Environment Variables

Create a .env file in the root directory:

# Server Configuration
NODE_ENV=production
PORT=10000

# Firebase Configuration (if using Firebase)
FIREBASE_API_KEY=your_api_key
FIREBASE_PROJECT_ID=your_project_id
FIREBASE_AUTH_DOMAIN=your_auth_domain

# API Configuration
API_BASE_URL=http://localhost:10000
FRONTEND_URL=http://localhost:4002

Production Deployment Checklist

Docker and Docker Compose installed Environment variables configured SSL certificates configured (for HTTPS) Backup strategy in place Monitoring and logging configured Firewall rules configured Database migrations run Performance testing completed

Troubleshooting Guide

Common Issues and Solutions

Solution: Change the port mapping in docker-compose.yml:

ports:
  - "3000:10000"  # Use 3000 instead of 4002

Or kill the process using the port:

# On Windows
netstat -ano | findstr :4002
taskkill /PID <PID> /F

# On Mac/Linux
lsof -i :4002
kill -9 <PID>

Solution: Check the logs:

docker-compose logs toolshub

Common causes:

Missing dependencies - Run npm install
Environment variables not set
Port already in use

Solution: Rebuild and restart the container:

docker-compose down
docker-compose build --no-cache
docker-compose up -d

Solution: Clean up Docker resources:

# Remove unused containers
docker container prune

# Remove unused images
docker image prune

# Remove all unused resources
docker system prune -a

Solution (Linux): Add user to docker group:

sudo usermod -aG docker $USER
newgrp docker

Log out and back in for changes to take effect.

Debug Mode

Enable debug logging for troubleshooting:

# View detailed container logs
docker-compose logs -f toolshub

# Execute commands in running container
docker exec -it toolshub-app bash

# Inspect container details
docker inspect toolshub-app

# Check resource usage
docker stats