NixOS Containers: Difference between revisions

From NixOS Wiki
imported>Frogamic
Updated config option to reflect docker -> oci-containers change
imported>Nix
m add Server category
Line 36: Line 36:


{{manual:nixos|sec=#ch-containers|chapter=Chapter on Container Management}}
{{manual:nixos|sec=#ch-containers|chapter=Chapter on Container Management}}
[[Category:Server]

Revision as of 04:57, 20 September 2021

There's not much to read here. Look at NixOS Manual, the upstream documentation on containers meanwhile.

Declarative docker containers

Example config:

 { config, pkgs, ... }:
 {
   config.virtualisation.oci-containers.containers = {
     hackagecompare = {
       image = "chrissound/hackagecomparestats-webserver:latest";
       ports = ["127.0.0.1:3010:3010"];
       volumes = [
         "/root/hackagecompare/packageStatistics.json:/root/hackagecompare/packageStatistics.json"
       ];
       cmd = [
         "--base-url"
         "\"/hackagecompare\""
       ];
     };
   };
 }

Troubleshooting

I have changed the host's channel and some services are no longer functional

Symptoms:

  • Lost data in PostgreSQL database
  • MySQL has changed its path, where it creates the database

Solution

If you did not have a system.stateVersion option set inside your declarative container configuration, it will use the default one for the channel. Your data might be safe, if you did nothing meanwhile. Add the missing system.stateVersion to your container, rebuild, and possibly stop/start the container.

See also

NixOS Manual, Chapter on Container Management

[[Category:Server]