runv-server

server tooling for runv.club
Log | Files | Refs | README

01-server-baseline-debian.md (1536B)


      1 # Baseline do servidor Debian
      2 
      3 [← Índice](README.md)
      4 
      5 ## Obrigatório (implícito nos scripts)
      6 
      7 - **Sistema:** **Debian** (o projecto referencia Debian 13 “trixie” em vários README históricos e docstrings; **não verificado** em cada release).
      8 - **Acesso:** capacidade de executar comandos como **root** (`sudo` ou sessão root) para bootstrap, `tools.py`, `genlanding.py`, `setup_entre.py`, `create_runv_user.py`.
      9 - **Python 3** instalado (scripts usam shebang `python3`).
     10 
     11 ## Recomendação operacional (não imposta pelo repo)
     12 
     13 - **Hostname** coerente com DNS público se for servir `runv.club` ou outro domínio.
     14 - **Hora:** NTP/chrony para timestamps correctos em logs e `created_at` (o repo **não** configura NTP por si).
     15 - **Locale UTF-8** para terminais e logs legíveis — padrão Debian moderno.
     16 
     17 ## Sistema de ficheiros e quotas
     18 
     19 - **`starthere.py`** e a lógica de quota em `create_runv_user.py` assumem **ext4** com **usrquota** no mount que contém `/home` (ou path de sonda). Se o FS não for ext4, a automatização de quota em `starthere.py` **falha de propósito** (mensagem de erro no script). **Evidência:** docstring `scripts/admin/starthere.py` (filesystem ext4).
     20 
     21 ## O que o repositório não faz
     22 
     23 - Não escolhe hostname por si.
     24 - Não configura NTP, locale ou timezone como passo dedicado (tratar como **pré-requisito de exploração** ou configuração manual Debian).
     25 
     26 ## Próximo passo
     27 
     28 [04-bootstrap-and-base-system.md](04-bootstrap-and-base-system.md) após garantir Debian + root + Python 3.