Configuration Guide

1. Introduction

This guide walks you through configuring the application to suit your needs. It covers everything from initial setup to advanced customizations.

2. Basic Setup

Open config.yaml located in the root directory and edit the following fields:

# config.yaml
server:
  host: "127.0.0.1"
  port: 8080
database:
  type: "postgres"
  url: "postgres://user:password@localhost:5432/dbname"
logging:
  level: "info"

After editing, restart the service:

systemctl restart myapp.service

3. Advanced Options

Use the --config flag to specify an alternative configuration file:

myapp --config /path/to/custom-config.yaml

Enable TLS by adding the following to config.yaml:

tls:
  enabled: true
  cert_file: "/etc/myapp/cert.pem"
  key_file: "/etc/myapp/key.pem"

4. Troubleshooting

• Cannot connect to database: Verify the url field and ensure the database is reachable.
• Port already in use: Change server.port to an unused port.
• TLS errors: Check that the certificate and key files exist and have correct permissions.

5. FAQ

How do I reload configuration without restarting?

Send a SIGHUP signal: kill -HUP $(pidof myapp)

Where are logs stored?

By default, logs are written to /var/log/myapp/app.log.