Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- navody:distribuce:nixos [2020/11/30 20:12] – remove outdated stuff Aither
+++ navody:distribuce:nixos [2026/08/10 17:49] (aktuální) – panika
@@ Řádek 1: / Řádek 1: @@
-===== NixOS =====
+<page>manuals:distributions:nixos</page>
+====== NixOS ======
+[[https://nixos.org|NixOS]] je distribuce založená na balíčkovacím systému Nix.
+Konfigurace systému a všech služeb se provádí deklarativně. Tato stránka popisuje
+použití NixOS na vpsFree.cz VPS. Pro více informací o NixOS obecně viz
+[[https://nixos.org/learn.html|dokumentace]].
-NixOS allows declarative configuration management of the whole system and deployed services.
+===== Podporované verze =====
+Poskytujeme šablony VPS pro stabilní vydání NixOS a průběžně pro NixOS unstable.
-To start using NixOS on vpsFree.cz, make sure you're on a node with [[navody:vps:vpsadminos]], you can recognize it e.g. by the kernel version:
+Sami NixOS používáme na naší
+[[https://github.com/vpsfreecz/vpsfree-cz-configuration|infrastruktuře]].
+Naše virtualizační platforma [[navody:vps:vpsadminos|vpsAdminOS]] je dokonce
+na NixOS a nixpkgs založená.
+===== Prvotní konfigurace =====
+VPS je vytvořeno ze šablony, která obsahuje minimální systém a SSH.
+Pro přihlášení je možné použít [[navody:vps:sprava#heslo_roota|vygenerované heslo]],
+nebo si nechat [[navody:vps:sprava#automaticke_vlozeni_klicu|nahrát veřejný klíč]] přes
+vpsAdmin. Systém lze pak spravovat pomocí ''nixos-rebuild'':
 <code>
-# uname -rv
+nixos-rebuild switch --flake /etc/nixos#vps
-.9.2 #1-vpsAdminOS SMP Fri Oct 30 12:31:53 UTC 2020
 </code>
-If you have set your public SSH keys in vpsAdmin the key will be automatically deployed and you can login as root right away. To be able to login with a password you need to set the password manually after your container is created.
+Naše VPS jsou linuxové kontejnery, není zde zavaděč, jádro je sdílené a je potřeba
+určité nastavení pro správnou funkci NixOS. V šabloně je proto vpsAdminOS jako flake input a potřebný
+modul je importován do konfigurace systému.
-==== Initial setup & informations ====
+Při vytvoření VPS a reinstalaci systému je možné do VPS přes vpsAdmin nahrát a nasadit vlastní
+konfiguraci, viz [[navody:vps:userdata|user data]].
-After installing NixOS (mainly talking about stable release) you **have to know**, that there is activated firewall by default blocking everything except ssh (port no. 22) so if you want to run some webserver (for example nginx) you have to tell firewall to not block your ports with this in your /etc/nixos/configuration.nix:nixos
+===== Správa VPS =====
+Přejdi na [[:domu|návody VPS]] pro více informací o naší infrastruktuře a možnostech VPS.
-<code>networking.firewall.allowedTCPPorts = [ 80 443 ];</code>
+===== Impermanence =====
+Viz [[navody:distribuce:nixos:impermanence]].
-Then don'rt forget to do
+===== GitHub API limit =====
+Nixpkgs se stahují z [[https://github.com/nixos/nixpkgs|GitHubu]] a [[https://nixos.wiki/wiki/Binary_Cache|Binary Cache]]. GitHub nepodporuje IPv6 a má limity buď [[https://docs.github.com/en/rest/using-the-rest-api/rate-limits-for-the-rest-api?apiVersion=2026-03-10#primary-rate-limit-for-unauthenticated-users|per IPv4]] nebo [[https://docs.github.com/en/rest/using-the-rest-api/rate-limits-for-the-rest-api?apiVersion=2026-03-10#primary-rate-limit-for-authenticated-users|per uživatel]].
+Při vyčerpání Nix (respektive GitHub API) zahlásí:
+<code>
+error: unable to download 'GITHUB_URL': HTTP error 403 ('')
-<code> nixos-rebuild switch</code> so your changes will take effect (without rebooting)
+       response body:
+       {"message":"API rate limit exceeded for IP_ADDR. (But here's the good news: Authenticated requests get a higher rate limit. Check out the documentation for more details.)","documentation_url":"https://docs.github.com/rest/overview/resources-in-the-rest-api#rate-limiting"}
+</code>
+Řešením je [[https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token|vyrobit si personal access token]] (Public repositories, v Permissions není potřeba nic) a [[https://search.nixos.org/options?channel=26.05&query=nix.settings&type=options#show=option%253Anix.settings|předat konfiguraci]] Nixu:
+<code>
+# configuration.nix
+nix.settings.access-tokens = [ "github.com=github_pat_TokenTokenChangeMe" ];
+</code>
-==== Configuration ====
-Configuration is available at <code>/etc/nixos/configuration.nix</code>
-This can be altered to change container configuration on the fly or for next reboot. Try changing container hostname and running <code>nixos-rebuild switch</code> to build new configuration and directly switch to it. To switch to new configuration after reboot (set as a default boot profile) use <code>nixos-rebuild boot</code>
-If you are using channels you can update your system by running <code>nixos-rebuild switch --upgrade</code>
-==== Package installation ====
-Packages can be installed system wide via configuration.nix or for local profile via <code>nix-env</code>
-To install vim use <code>nix-env -iA nixos.vim</code>
-To search for a package use <code>nix-env -qaP postgre</code>
-==== Manual ====
-Consult NixOS manual for more https://nixos.org/nixos/manual/

Znalostní báze

Uživatelské nástroje

Nástroje pro tento web

Rozdíly

Nástroje pro stránku