Differences

This shows you the differences between two versions of the page.

--- manuals:distributions:nixos [2025/03/16 21:07] – Add example flake configuration aither
+++ manuals:distributions:nixos [2026/08/10 17:49] (current) – panika
@@ Line 18: / Line 18: @@
 You can log in using a [[manuals:vps:management#root_password|generated password]]
 or [[manuals:vps:management#ssh_public_keys|deploy your public key]] using vpsAdmin.
-The system can then be configured using ''nixos-rebuild'' or any other
+The system can then be configured using :
-deployment tool.
+<code>
+nixos-rebuild switch --flake /etc/nixos#vps
+</code>
 Note that our VPS are Linux containers, so there is no boot loader, the kernel is shared
-and some configuration is required for the VPS to work properly. The template installs
+and some configuration is required for the VPS to work properly. The template handles this by using vpsAdminOS as flake input and importing the necessary module.
-this configuration into ''/etc/nixos/vpsadminos.nix'', which is imported by
-''/etc/nixos/configuration.nix''. The up-to-date configuration module
-can be always found at
-[[https://github.com/vpsfreecz/vpsadminos/blob/staging/os/lib/nixos-container/vpsadminos.nix]].
 It is possible to deploy custom configuration using vpsAdmin on VPS creation and reinstallation,
 see [[manuals:vps:userdata|user data]].
-===== Example flake configuration =====
-See [[https://github.com/vpsfreecz/example-vps-flake|example-vps-flake]] if you wish deploy
-your VPS using NixOS flakes. The configuration which is otherwise stored in
-''/etc/nixos/vpsadminos.nix'' is added as flake input.
 ===== VPS management =====
-See the [[:home|VPS manuals]] for more information about our infrastructure and possibilies.
+See the [[:home|VPS manuals]] for more information about our infrastructure and possibilities.
 ===== Impermanence =====
 See [[manuals:distributions:nixos:impermanence]].
+===== GitHub API limit =====
+Nixpkgs  are downloaded from [[https://github.com/nixos/nixpkgs|GitHub]] and [[https://nixos.wiki/wiki/Binary_Cache|Binary Cache]]. GitHub does not support IPv6 and rate limits either  [[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]] or [[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 user]].
+After exhausting the API limit, Nix (or rather GitHub API) complains:
+<code>
+error: unable to download 'GITHUB_URL': HTTP error 403 ('')
+       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>
+The solution is to [[https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token|create personal access token]] (Public repositories, the Permissions could be blank) and enter [[https://search.nixos.org/options?channel=26.05&query=nix.settings&type=options#show=option%253Anix.settings|the configuration]] to Nix:
+<code>
+# configuration.nix
+nix.settings.access-tokens = [ "github.com=github_pat_TokenTokenChangeMe" ];
+</code>

Knowledge base

User Tools

Site Tools

Differences

Page Tools