• Docs
  • Login
Talk to an expertTry for free

Choose an image type

Configure your app and control how it's built and deployed. Choose a single-runtime image for simplicity, or a composable image when you need to build your own.

Start a free trialSchedule a demo

Two images. More flexibility.

Single-runtime applications

One supported runtime per container, chosen from nine languages including PHP, Python, Node.js, Ruby, Java, Go, and more. Upsun patches and updates it automatically, so there's less to configure and less to maintain.

Composable image

Build your own container. Mix multiple runtimes in one image, and add from over 120,000 Nix packages for custom tools, binaries, and dependencies. Full control, with the update cadence in your hands.

Built to match your setup and maintenance tradeoffs

  • Single-runtime images support 9 languages, each patched and updated automatically by Upsun
  • Composable images let you combine multiple runtimes in a single container, with one runtime running automatically and others started manually
  • Composable images draw from over 120,000 Nix packages for custom binaries, tools, and dependencies
  • Both image types support multi-application projects, and can be mixed within one
  • Choose per application: single-runtime for simple services, composable for anything custom

What each choice actually gets you

Less to patch, less to break

Upsun applies security patches and minor updates automatically to single-runtime images. No redeploying just to stay current.

Build exactly what you need

Composable images let you define runtimes, packages, and binaries through Nix, so nothing ships that your application doesn't use.

Run more than one runtime, in one container

Combine a primary runtime with secondary ones, like PHP alongside Node.js and Python, in a single composable image.

No forced tradeoff

Mix single-runtime and composable images within the same multi-application project. Use the simpler option where you can, the flexible one where you need it.

Own your update cadence

With composable images, you control when to update Nix packages, on your own schedule rather than a platform-imposed one.

One config file, either way

Both image types are defined in the same YAML file, so switching between them doesn't mean learning a new configuration system.

Build it your way. Run it on Upsun.