public/dropshell-templates
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
cb4bf8451ffb602b6551f89c8c004a76bb2330d1
dropshell-templates/logserver/README.md
Your Name cb4bf8451f
All checks were successful
Test and Publish Templates / test-and-publish (push) Successful in 40s
Details
make it easy
2025-09-20 11:25:54 +12:00

1.1 KiB
Raw Blame History

LogServer

Centralized logging with ELK Stack (Elasticsearch, Logstash, Kibana).

Quick Start

  1. System Setup
sudo sysctl -w vm.max_map_count=262144
  1. Configure Edit config/service.env:
  • Set SERVER_PUBLICBASEURL to your actual server URL
  • Set KIBANA_USERNAME to your preferred username
  • Change KIBANA_USER_PASSWORD from default
  1. Install
dropshell install logserver
  1. Generate Client Keys
./generate-api-key.sh
# Enter hostname when prompted
# Save the API key for client configuration
  1. Setup Kibana (first time only)
./setup-kibana.sh
  1. Access Kibana
  • URL: http://<server-ip>:5601
  • Username: Set in service.env (KIBANA_USERNAME, default: admin)
  • Password: Set in service.env (KIBANA_USER_PASSWORD)
  • Click "Discover" → View your logs!

Ports

  • 5601 - Kibana Web UI
  • 5044 - Log ingestion (Filebeat)

Files

  • config/service.env - Configuration
  • config/api-keys.yml - Client API keys
  • generate-api-key.sh - Add new clients

See DOCUMENTATION.md for full details.