Pular para o conteúdo
Chapters
  1. Bem-vindo ao Omarchy!
  2. Primeiros passos
  3. Vindo do Mac ou do Windows
  4. Navegação
  5. A Barra Superior
  6. Temas
  7. Atalhos de teclado
  8. Área de Transferência Unificada e Histórico
  9. Lembretes
  10. Avisos
  11. Extração de Texto e Ditado
  12. Capturas de Tela e Gravação
  13. Alternâncias, Ociosidade e o Protetor de Tela
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. IA
  18. Ferramentas de Desenvolvimento
  19. Ferramentas de shell
  20. Funções de shell
  21. TUIs
  22. GUIs
  23. Navegadores
  24. Aplicativos/serviços comerciais
  25. Aplicativos web
  26. Jogos
  27. Preenchendo PDFs
  28. VM do Windows
  29. Outros pacotes
  30. Atualizações
  31. Dotfiles
  32. Plug-ins do shell
  33. Monitores
  34. Teclado, Mouse, Trackpad
  35. Rede
  36. Suspensão do sistema
  37. Autenticação por hardware
  38. Fontes
  39. Planos de fundo
  40. Prompt
  41. Identidade visual
  42. Ajustes comuns
  43. Criando seu próprio tema
  44. Suporte a Mac
  45. Solução de problemas
  46. FAQ
  47. Snapshots do sistema
  48. Segurança
  49. Omarchy em...
  50. Instalação em Dual Boot
  51. Instalações autônomas

Manual

Instalações autônomas

A ISO do Omarchy pode se instalar sem ninguém no teclado. Se o instalador encontrar um segundo disco com o rótulo cidata contendo seus arquivos de configuração, ele os copia, pula o assistente de configuração por completo e reinicia sozinho no sistema pronto. Nenhuma versão especial da ISO, nenhuma entrada extra no menu de inicialização - sem um disco assim conectado, nada muda e você tem o assistente normal.

Isso torna o Omarchy ótimo como imagem base para ambientes de desenvolvimento descartáveis: crie uma VM no Proxmox ou com o Packer, inicialize, saia de perto, acesse por SSH. cidata é o rótulo NoCloud do cloud-init, então todas as ferramentas comuns de virtualização já sabem como conectar um disco assim.

Os arquivos de configuração

Os arquivos são exatamente os que o próprio assistente do instalador grava, então a maneira mais fácil de obter um conjunto inicial é executar uma instalação interativa (numa VM, por exemplo) e copiar o que ele gravou em /root:

Arquivo Obrigatório Finalidade
user_configuration.json Sim Disco, nome do host, fuso horário, teclado
user_credentials.json Sim Nome de usuário e hash da senha
user_encrypt_installation.txt Não true quando a configuração contém um bloco disk_encryption
authorized_keys Não Chaves públicas SSH, uma por linha
tailscale_authkey Não Chave de autenticação do Tailscale para entrar no seu tailnet na primeira inicialização

Gere o hash da senha para user_credentials.json com openssl passwd -6 "yourpassword".

O nome e o e-mail para os commits do git não fazem parte da instalação. Configure-os quando a máquina estiver no ar, por SSH, por exemplo, com omarchy setup git --name "Jane Doe" --email jane@example.com.

Você também pode colocar um arquivo vazio chamado defer-provisioning no lugar de user_credentials.json. Isso executa a mesma instalação de preparação para outro proprietário que você pode acionar interativamente: a máquina é instalada sem nenhum dado pessoal, e quem a inicializar primeiro escolhe o teclado e cria seu usuário. Esse é o modo para equipamentos de imagem, em que o disco não deve carregar as credenciais de ninguém.

Acesso por SSH

Quando authorized_keys está presente, a instalação configura as chaves como o ~/.ssh/authorized_keys do usuário, ativa o sshd e abre o firewall para ele. (Uma instalação padrão do Omarchy vem com o openssh com o serviço desativado e a porta fechada, então uma máquina autônoma ficaria inacessível de outra forma.) A instalação só adiciona as suas chaves - ela não afrouxa nenhuma das outras configurações de autenticação do daemon SSH.

Quando tailscale_authkey está presente, a máquina entra no seu tailnet na primeira inicialização: o Tailscale é instalado a partir dos pacotes incluídos na ISO, o firewall permite a interface do tailnet e um trabalho em segundo plano executa a entrada assim que a máquina realmente tiver rede, tentando de novo até conseguir. Use uma chave reutilizável e pré-autorizada para que uma única imagem de disco possa atender muitas máquinas.

Criando o disco cidata

Qualquer sistema de arquivos com o rótulo certo funciona. Uma ISO minúscula é a maneira fácil:

mkdir cidata
cp user_configuration.json user_credentials.json authorized_keys cidata/
genisoimage -output cidata.iso -volid cidata -joliet -rock cidata/

Depois conecte-o à VM junto com a ISO do Omarchy. Aqui está um exemplo completo no Proxmox:

qm create 101 --name my-omarchy \
  --bios ovmf --machine q35 --cpu host --cores 4 --memory 8192 \
  --ostype l26 --scsihw virtio-scsi-single \
  --efidisk0 local-lvm:0,efitype=4m,pre-enrolled-keys=0 \
  --scsi0 local-lvm:40,discard=on,iothread=1 \
  --net0 virtio,bridge=vmbr0 --vga virtio --serial0 socket \
  --ide2 local:iso/omarchy.iso,media=cdrom \
  --ide3 local:iso/cidata.iso,media=cdrom \
  --boot order='scsi0;ide2'

qm start 101

A ordem de inicialização coloca o disco em primeiro de propósito: o disco vazio passa direto para a ISO na primeira inicialização, e o sistema instalado inicializa a partir do disco para sempre depois disso.

Dois avisos

Instalações autônomas criptografadas não são totalmente autônomas - alguém ainda precisa digitar a senha LUKS na primeira inicialização. E o bloco disk_encryption em user_configuration.json carrega essa senha em texto simples, então trate um disco cidata criado a partir de uma instalação criptografada como o segredo que ele é.