Skip to content

Install Applications

Install software inside your FlatImage using package managers or recipes.

Prerequisites

Grant network permission for package downloads:

./app.flatimage fim-perms add wayland,xorg,network,audio

Using Recipes

Recipes install curated package sets with dependencies resolved automatically.

Setup Remote Repository

./app.flatimage fim-remote set https://raw.githubusercontent.com/flatimage/recipes/master

Install a Recipe

# Enable permissions
./app.flatimage fim-perms set wayland,xorg,audio,network

# Install firefox
./app.flatimage fim-recipe install firefox

Using Package Managers

Alpine Linux (apk)

# Update package index
./alpine.flatimage fim-root apk update

# Install packages
./alpine.flatimage fim-root apk add firefox font-noto

Arch Linux (pacman)

# Update system
./arch.flatimage fim-root pacman -Syu

# Install packages
./arch.flatimage fim-root pacman -S firefox noto-fonts

Verify Installation

Run the installed application:

# As regular user
./app.flatimage fim-exec firefox

# Check if binary exists
./app.flatimage fim-exec which firefox

Learn More

  • fim-root for root permissions in the container.
  • fim-exec to execute commands as a regular user.
  • fim-perms to configure permissions.
  • fim-remote to setup a remote to pull recipes from.
  • fim-recipe to fetch and install recipes.