# IT-Tools

Collection of handy developer and sysadmin tools (encoders, converters, token
generators, network calculators) served as a static site. Everything runs
client-side in the browser.

## Persistent Data

None. The container is stateless; nothing needs backing up.

## Installation

1. Create `.env` if it does not exist:

   ```bash
   cp -n .env.sample .env
   ```

2. Adjust the values in `.env` if needed:

   ```dotenv
   TZ=Africa/Johannesburg
   IT_TOOLS_PORT=80
   IT_TOOLS_MEM_LIMIT=128m

   DOCKERLOGGING_MAXFILE=3
   DOCKERLOGGING_MAXSIZE=10m
   ```

3. Deploy with `make`:

   ```bash
   make deploy-it-tools
   ```

   Manual equivalent:

   ```bash
   ./substitute_env.sh docker-compose-files/it-tools/template.yaml docker-compose.it-tools.yml .env
   docker compose -f docker-compose.it-tools.yml config --quiet
   docker compose -f docker-compose.it-tools.yml up -d
   ```

4. Verify the container and open `http://<host-ip>`:

   ```bash
   docker compose -f docker-compose.it-tools.yml ps
   docker compose -f docker-compose.it-tools.yml logs --tail=100 it-tools
   ```

## Reverse Proxy

The Caddyfile proxies `it-tools.<domain>` to this host on port 80. After
changing the port, update `docker-compose-files/caddy/Caddyfile_template` and
run `make reload-caddy`.

## Useful Commands

```bash
# Tail logs
docker compose -f docker-compose.it-tools.yml logs -f it-tools

# Recreate after an image update
docker compose -f docker-compose.it-tools.yml pull
docker compose -f docker-compose.it-tools.yml up -d
```