StackPanel

Containers Module

Documentation for the containers module

OCI container image building with nix2container or dockerTools.

Overview

Builds container images for apps using either nix2container (default, layer-optimized) or nixpkgs dockerTools. Supports per-app container configuration and direct image definitions.

Files

FileDescription
default.nixModule entry point
module.nixContainer options and build logic
builder.nixBackend-specific image builders
schema.nixProto-derived container config schema
ui.nixWeb studio panel definitions
meta.nixModule metadata

Usage

# Per-app containers
stackpanel.apps.web.container = {
  enable = true;
  type = "bun";
  port = 3000;
};

# Or direct image definitions
stackpanel.containers.images.my-image = {
  name = "my-app";
  type = "bun";
  port = 3000;
};

Commands

CommandDescription
container-build <name>Build a container image
container-copy <name>Build and push to registry
container-run <name>Build and run locally

On this page