History

Kiara Grouwstra f947e17d96 allow accessing test vms from fedi201's machine ssh key, closes #286		2025-04-09 17:00:01 +02:00
..
main.tf	allow accessing test vms from fedi201's machine ssh key, closes #286	2025-04-09 17:00:01 +02:00
README.md	allow accessing test vms from fedi201's machine ssh key, closes #286	2025-04-09 17:00:01 +02:00
update-url-map	allow accessing test vms from fedi201's machine ssh key, closes #286	2025-04-09 17:00:01 +02:00
url_map.nix	allow accessing test vms from fedi201's machine ssh key, closes #286	2025-04-09 17:00:01 +02:00
url_map.tf	allow accessing test vms from fedi201's machine ssh key, closes #286	2025-04-09 17:00:01 +02:00
versions.tf	allow accessing test vms from fedi201's machine ssh key, closes #286	2025-04-09 17:00:01 +02:00

README.md

AWS Collection of NixOS AMIs

This terraform module provides links to official NixOS AMIs on AWS. The AMIs are released by the NixOS project.

Since image names are unique, only one instance per version of the module is supported.

Example

provider "aws" {
  region = "eu-west-1"
}

module "nixos_image_1903" {
  source  = "path/to/aws_image_nixos"
  release = "19.03"
}

resource "aws_instance" "example" {
  ami           = module.nixos_image_1903.ami
  instance_type = "t2.micro"

  ...
}

New NixOS releases

Run the ./update-url-map script to fetch new image releases.

Inputs

Name	Description	Type	Default	Required
region	The region to use. If not provided, current provider's region will be used.	string	``	no
release	The NixOS version to use. For example, 18.09	string	`latest`	no
type	The type of the AMI to use -- hvm-ebs, pv-ebs, or pv-s3.	string	`hvm-ebs`	no
url_map	A map of release series to actual releases	map	`<map>`	no

Outputs

Name	Description
ami	NixOS AMI on AWS