{"id":14461274,"url":"https://github.com/tfc/nixos-auto-installer","last_synced_at":"2025-10-28T01:50:05.804Z","repository":{"id":137344604,"uuid":"562771868","full_name":"tfc/nixos-auto-installer","owner":"tfc","description":"Build recipe for an unattended, offline capable USB-bootable NixOS installer to bootstrap random computers","archived":false,"fork":false,"pushed_at":"2024-01-15T15:55:11.000Z","size":159,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-01-15T20:29:32.536Z","etag":null,"topics":["installer","nix","nixos","unattended-installation"],"latest_commit_sha":null,"homepage":"","language":"Nix","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tfc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-11-07T08:20:10.000Z","updated_at":"2024-04-14T17:30:06.504Z","dependencies_parsed_at":"2024-04-14T17:30:06.137Z","dependency_job_id":"f27940f1-9698-4c19-8a71-a2dd3c198a9d","html_url":"https://github.com/tfc/nixos-auto-installer","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"purl":"pkg:github/tfc/nixos-auto-installer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tfc%2Fnixos-auto-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tfc%2Fnixos-auto-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tfc%2Fnixos-auto-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tfc%2Fnixos-auto-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tfc","download_url":"https://codeload.github.com/tfc/nixos-auto-installer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tfc%2Fnixos-auto-installer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261987421,"owners_count":23240842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["installer","nix","nixos","unattended-installation"],"created_at":"2024-09-01T21:02:24.927Z","updated_at":"2025-10-28T01:50:05.761Z","avatar_url":"https://github.com/tfc.png","language":"Nix","funding_links":[],"categories":["Nix"],"sub_categories":[],"readme":"# nixos-auto-installer\n\nBuild recipe for an unattended, offline capable USB-bootable NixOS installer to bootstrap random computers.\n\nI typically use this to \"transform\" random computers to minimally setup NixOS machines by putting in my USB stick and boot from it.\nAfterward, the machine can be rebootet and then i can deploy whatever config i want over it from remote via SSH.\nThe system is really just meant as a trampoline for installing \"real\" system configs from remote.\n\n## Usage\n\n**Warning:** The created USB stick is destructive in the sense that it deletes everything on the disk without asking!\n\n1. Build the ISO image via `nix build`\n2. `dd` the ISO image over a USB stick\n3. Put the USB stick into a machine that is set up to boot via USB\n4. Let the machine boot and wait until it powers off again. (It typically takes ~5 minutes)\n5. NixOS is now installed. Just SSH into it.\n\n## Installation Scheme\n\nThe installer [partitions the disk](https://github.com/tfc/nixos-auto-installer/blob/main/installer.nix#L35) like this:\n\n- 512 MiB fat32 boot partition\n- 8 GiB swap partition\n- rest size ext4 nixos partition\n\nThe `root` user is the only user on the system. The password is `nixcademy`.\n\nUnfree modules for wifi are added in order to enable the machine's wifi on first boot.\n\nOnly SSH is installed as a service.\n\n## Customization\n\n### WiFi\n\nAdd a wifi config to [`configuration.nix`](./configuration/configuration.nix) to let the machine automatically into your wifi after installation:\n\n```nix\n  networking.wireless = {\n    enable = true;\n    networks.\"my-wifi-name\".psk = \"my-wifi-password\";\n    userControlled.enable = true;\n  };\n```\n\nThere are different ways to add passwords to a machine, and _this_ is not a secure one as the password will be stored in the nix store.\n(Which is fine for _my_ purposes, but maybe not yours)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftfc%2Fnixos-auto-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftfc%2Fnixos-auto-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftfc%2Fnixos-auto-installer/lists"}