docs for debrpm stuff

This commit is contained in:
Dvlv 2024-02-12 18:00:31 +00:00
parent 057201c1ec
commit 40af3b6747
No known key found for this signature in database
GPG key ID: 1F4BD7220B7FDCFA
4 changed files with 21 additions and 7 deletions

View file

@ -22,8 +22,7 @@ Note that this does not come with Podman or Distrobox, those will need to be ins
Documentation lives at the [GitHub Pages site.](https://dvlv.github.io/BoxBuddyRS)
## Contributing
Please see the dedicated [contributing.md file.](https://github.com/Dvlv/BoxBuddyRS/blob/master/docs/CONTRIBUTING.md)
Please see the dedicated [Dev Documentation](https://dvlv.github.io/BoxBuddyRS/dev-docs) and [Translator Documentation.](https://dvlv.github.io/BoxBuddyRS/translator-docs)
## Help Wanted
Help would be greatly appreciated in these areas:

View file

@ -9,8 +9,8 @@ Some features require filesystem access, which is not granted by default. Please
## What terminals are supported?
BoxBuddy will try to spawn the following terminals, in the following order:
- GNOME Terminal
- GNOME Console
- GNOME Terminal
- Konsole
- Tilix
- Kitty

View file

@ -20,7 +20,7 @@ If you wish to use Distrobox's Assemble feature, click the hammer icon in the to
This will spawn a file-chooser window. Select your `.ini` file and press the blue "Open" button in the file-chooser's header bar.
A popup window will appear with a loading spinner, letting you know that your boxes are being created. Upon completion this window will disappear and your new boxes should appear in BoxBuddy.
A pop-up window will appear with a loading spinner, letting you know that your boxes are being created. Upon completion this window will disappear and your new boxes should appear in BoxBuddy.
**Note** These boxes will need to be initialised before they can be used. Simply click the "Open Terminal" button against each box and wait for the initialisations to finish.
@ -42,15 +42,29 @@ If a box is running there will be a stop symbol in the top-right of the applicat
If the box is definitely running but the button does not appear, click the Reload button in the titlebar (The curved arrow) to reload BoxBuddy's UI. This should update the box's current status and make the stop button appear.
### Removing a Box
Click the "Delete Box" button to remove a box. A confirmation popup will appear to make sure you wish to permanently delete the box. Click "Delete" to confirm, or "Cancel" to go back.
Click the "Delete Box" button to remove a box. A confirmation pop-up will appear to make sure you wish to permanently delete the box. Click "Delete" to confirm, or "Cancel" to go back.
### Managing Applications
#### Installing / Removing
There is currently no way to install or remove applications inside a box using BoxBuddy itself. To install packages, use the "Open Terminal" button to spawn a terminal inside your box, then use the distro's package manager to install and remove packages.
Any boxes which support `.deb` or `.rpm` files will have a button labelled "Install .deb File" or "Install .rpm File". Click this button and choose a `.deb` or `.rpm` file to install.
A terminal window will appear with the output from your box's package manager asking you to confirm the packages to install. If you are happy to proceed, type a `y` into the terminal and press `Enter`. The install will then begin. To cancel the install, type an `n` and press `Enter`.
You may also right-click a `.deb` or `.rpm` file in your file manager and choose "Open with BoxBuddy".
![Nautilus right-click menu](nautilus-right-click.png)
This will open BoxBuddy with a pop-up asking you to choose the box to install this file into. Select your choice of box from the dropdown and press the blue "Install" button in the header bar to begin the installation.
If no boxes supporting the file could be found, BoxBuddy will instead show an error message to let you know that it cannot find an appropriate box. For `.deb` files, a **Debian** box is recommended, and for `.rpm` files a **Fedora** box is recommended.
To install files with the box's CLI package manager, use the "Open Terminal" button to spawn a terminal inside your box, then use the package manager to install and remove packages.
There is currently no way to uninstall an application using BoxBuddy's interface - you must open a terminal and use the package manager to uninstall things.
#### Running
Click the "View Applications" button to see a popup containing a list of all applications installed in the box. This may take a few seconds to load.
Click the "View Applications" button to see a pop-up containing a list of all applications installed in the box. This may take a few seconds to load.
Click the "Run" button next to your desired application to execute it.

View file

@ -8,6 +8,7 @@ The flatpak version of BoxBuddy is sandboxed, and cannot access the user's files
- Choosing a Custom Home Directory when creating a box requires `home` access.
- Using Distrobox Assemble requires `home` access.
- Adding Additional Volumes to a container requires `host` access.
- Installing `.deb` / `.rpm` files can only be done with files which are in your `~/Downloads` directory. To install files from other locations you must allow `home` access.
### Allowing Filesystem Access via Flatseal
Install Flatseal if you haven't already: