example how to use

[dezren39]

hi! i like the interface you've got here i'm just not entirely clear how to use it can you please help me with just a few examples?

---

i think i understand how to pass extraConfig into the vm, i'm not sure how to use custom container images that aren't dockerhub images like mysql. i'm not clear how to, say, pass a nixos config as a container? i've read through the link to the docker documentation and am sort of familiar with things like https://xeiaso.net/talks/2024/nix-docker-build/ but i'm not clear, can i pass an image directly into the config or something?

  bash = buildImage {
    name = "bash";
    tag = "latest";
    copyToRoot = pkgs.buildEnv {
      name = "image-root";
      paths = [ pkgs.bashInteractive ];
      pathsToLink = [ "/bin" ];
    };
  };

how do i get that into config.server.containers.myApp.docker.containers.bash.image ? are virtualisation.oci-containers.containers images usable if the image string matches the container name i built?

where is config.server.containers.extraConfiguration exposed ?

---

how do i get the networking stuff working i guess? what parts of docker are available, can i expose a port? do the oci-containers exposedPorts get automatically exposed or something? what's available for vm networking? can i bind a docker container folder to the host?

is it possible to have multiple networks for vms/containers or do like, docker-compose type linking of vms/containers together so postgres could be used by webapp container only? guessing an issue here is what you mentioned in the readme about not being able to reference nixos containers by name.

i want to use vlans etc at some point but i also sometimes want to be able to bridge the vm's interface and pull an ip from dhcp same as the host uses. is there a way to use this without manual ip assignment?

similarly, sometimes i might want to have a network within my host and have my host act as the gateway/dhcp/maybe-dns server so that the vm/container gets an ip from host and then gets internet through host. the host could have access to this network or not. an easy way to expose/bind a host port through to a vm port would be great. i'm imagining something like how docker works i guess, possibly interaction between containers and vms.

---

sorry i know this is a lot i don't expect this is all available i'm just trying to understand how best to use this, where it's limits are now, what you plan to do with it and what's out of scope? a lot of this probably relates to #1 adding docker-compose support