Jeena
0459cb6220
- Add hostname-based request routing for multiple capsules per server - Parse virtual host configs from TOML sections ([hostname]) - Implement per-host certificate and content isolation - Add comprehensive virtual host testing and validation - Update docs and examples for multi-host deployments This enables Pollux to serve multiple Gemini domains from one instance, providing the foundation for multi-tenant Gemini hosting.
68 lines
No EOL
2.5 KiB
TOML
68 lines
No EOL
2.5 KiB
TOML
# Pollux Gemini Server Configuration
|
|
#
|
|
# This is an example configuration file for the Pollux Gemini server.
|
|
# Copy this file to /etc/pollux/config.toml and customize the values below.
|
|
#
|
|
# The Gemini protocol is specified in RFC 1436: https://tools.ietf.org/rfc/rfc1436.txt
|
|
|
|
# For additional hostnames, add more sections like:
|
|
# ["blog.example.com"]
|
|
# root = "/var/gemini/blog"
|
|
# cert = "/etc/pollux/tls/blog.crt"
|
|
# key = "/etc/pollux/tls/blog.key"
|
|
|
|
# Server network configuration
|
|
#
|
|
# bind_host: IP address or interface to bind the server to
|
|
# - "0.0.0.0" = listen on all interfaces (default)
|
|
# - "127.0.0.1" = localhost only
|
|
# - "::" = IPv6 all interfaces
|
|
# - Specific IP = bind to that address only
|
|
bind_host = "0.0.0.0"
|
|
|
|
# port: TCP port to listen on
|
|
# - Default Gemini port is 1965
|
|
# - Ports below 1024 require root privileges
|
|
# - Choose a different port if 1965 is in use
|
|
port = 1965
|
|
|
|
# Request limiting
|
|
#
|
|
# max_concurrent_requests: Maximum number of simultaneous connections
|
|
# - Prevents server overload and DoS attacks
|
|
# - Set to 0 to disable limiting (not recommended)
|
|
# - Typical values: 100-10000 depending on server capacity
|
|
max_concurrent_requests = 1000
|
|
|
|
# Logging configuration
|
|
#
|
|
# log_level: Controls how much information is logged
|
|
# - "error": Only errors that prevent normal operation
|
|
# - "warn": Errors plus warnings about unusual conditions
|
|
# - "info": General operational information (recommended)
|
|
# - "debug": Detailed debugging information
|
|
# - "trace": Very verbose debugging (use only for troubleshooting)
|
|
log_level = "info"
|
|
|
|
# Host configuration
|
|
# Each hostname needs its own section with root, cert, and key settings
|
|
["example.com"]
|
|
# Directory containing your Gemini files (.gmi, .txt, images, etc.)
|
|
# The server will serve files from this directory and its subdirectories.
|
|
# Default index file is 'index.gmi' for directory requests.
|
|
#
|
|
# IMPORTANT: The server needs READ access to this directory.
|
|
# Make sure the service user can read all files here.
|
|
root = "/var/gemini"
|
|
|
|
# TLS certificate and private key files
|
|
# These files are required for TLS encryption (Gemini requires TLS).
|
|
#
|
|
# For self-signed certificates (development/testing):
|
|
cert = "/etc/pollux/tls/cert.pem"
|
|
key = "/etc/pollux/tls/key.pem"
|
|
#
|
|
# Generate self-signed certs with:
|
|
# openssl req -x509 -newkey rsa:4096 -keyout /etc/pollux/tls/key.pem -out /etc/pollux/tls/cert.pem -days 365 -nodes -subj "/CN=example.com"
|
|
#
|
|
# For Let's Encrypt certificates, use paths under /etc/letsencrypt/live/ |