movefasta/nixpkgs
1
0
Fork 0
mirror of https://github.com/NixOS/nixpkgs.git synced 2025-06-10 03:23:29 +03:00
Code Issues Projects Releases Packages Wiki Activity

nixos/manual: enhance appimage instructions

Browse source 
Following a bug report (#350383) about `appimage-run` missing a
shared library, add instructions to nixos manual.
This commit is contained in:
zi3m5f 2024-10-23 23:02:33 +02:00
parent 4dbb808a7d
commit 20ebe18d2c
No known key found for this signature in database
1 changed files with 18 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

22
nixos/doc/manual/configuration/adding-custom-packages.section.md
View file

@ -90,16 +90,30 @@ Hello, world!
Most pre-built executables will not work on NixOS. There are two notable Most pre-built executables will not work on NixOS. There are two notable
exceptions: flatpaks and AppImages. For flatpaks see the [dedicated exceptions: flatpaks and AppImages. For flatpaks see the [dedicated
section](#module-services-flatpak). AppImages will not run "as-is" on NixOS. section](#module-services-flatpak). AppImages can run "as-is" on NixOS.
First you need to install `appimage-run`: add to `/etc/nixos/configuration.nix`
First you need to enable AppImage support: add to `/etc/nixos/configuration.nix`
```nix ```nix
{ {
environment.systemPackages = [ pkgs.appimage-run ]; programs.appimage.enable = true;
programs.appimage.binfmt = true;
} }
``` ```
Then instead of running the AppImage "as-is", run `appimage-run foo.appimage`. Then you can run the AppImage "as-is" or with `appimage-run foo.appimage`.
If there are shared libraries missing add them with
```nix
{
programs.appimage.package = pkgs.appimage-run.override {
extraPkgs = pkgs: [
# missing libraries here, e.g.: `pkgs.libepoxy`
];
}
}
```
To make other pre-built executables work on NixOS, you need to package them To make other pre-built executables work on NixOS, you need to package them
with Nix and special helpers like `autoPatchelfHook` or `buildFHSEnv`. See with Nix and special helpers like `autoPatchelfHook` or `buildFHSEnv`. See