Skip to content

Config File

Jump to bottom
Benny Bergle edited this page Mar 27, 2024 · 7 revisions

Configuring Your Network and Server with Genisys: A Comprehensive Guide

This document serves as a comprehensive manual to understand and implement the settings within the configuration file effectively.

Table of Contents

  1. Introduction
  2. Network Configuration
  3. Server Settings
  4. Operating System
  5. User Management
  6. Applications
  7. DNSMasq Overrides
  8. Scripts and Automation
  9. Ansible Integration

Introduction

The configuration file is a YAML document designed to set up your network, server, and applications for a Genisys-powered environment. It covers everything from network settings to user permissions, integrating services like DHCP, DNS, FTP, and more.

Network Configuration

Interface and IP Settings

  • Interface (eth0): The primary network interface for managing network traffic.
  • Subnet (10.0.0.0/24): Defines the subnet for the network.
  • Netmask (255.255.255.0): Specifies the netmask for the subnet.
  • IP Address (10.0.0.1): The static IP address assigned to the interface.

DHCP Configuration

  • DHCP Ranges (10.0.0.100-10.0.0.254): Specifies the range of IP addresses to be dynamically assigned.
  • Lease Time (12h): Duration for which a DHCP lease is valid.
  • DHCP Service: Enabled by default (no-dhcp: false).

NAT and Routing

  • NAT Requests: Enables NAT on the network (nat-requests: true).
  • NAT Interface (eth1): The interface used for NAT, facilitating internet access for devices in the subnet.

TFTP and DNS Settings

  • TFTP Directory (/tftpboot): The root directory for TFTP server files.
  • TFTP Port (69): The port on which the TFTP server listens.
  • DNS Servers (1.1.1.1): Specifies external DNS servers for resolving domain names.
  • DNS Service: Enabled by default (no-dns: false).

FTP Configuration

  • FTP Directory (/ftp): The root directory for FTP server files.
  • FTP Port (20): The port on which the FTP server listens.

Server Settings

Port and Privilege Settings

  • Server Port (15206): The preferred port for the server to listen on.
  • User/Group (genisys): Specifies the user and group under which the server should operate.
  • Working Directory (/srv/genisys): The directory from which the server process is run.

SSL Configuration

  • SSL Certificates: Defines the paths to SSL certificate and key for encrypted communication.

Operating System

  • OS (debian): The operating system to be used.
  • Version Name (bookworm): Specifies the version of the operating system.
  • Target Architecture (amd64): The architecture for which the system is configured.

User Management

  • Root Access: Allows login as root user.
  • Users: Defines usernames, passwords, and SSH key paths for user management.
  • Sudoer: Grants sudo privileges to specified users.

Applications

Specifies a list of applications to be installed on the system, e.g., curl.

DNSMasq Overrides

Allows customization of DNSMasq settings, such as setting the server to non-authoritative mode.

Scripts and Automation

  • Script Directory: The directory where scripts are stored.
  • Automation Scripts: Lists scripts to be executed, facilitating automation and management.

Ansible Integration

  • Inventory and SSH Keys: Configures Ansible integration with inventory file paths and SSH keys for playbook execution.
  • Playbooks: Lists Ansible playbooks to be run for server setup and management.

This guide is designed to help you navigate and understand the configuration options available in your Genisys configuration file. Each section corresponds to a part of the configuration

Clone this wiki locally