2018-10-25 15:27:29 +00:00
|
|
|
# Fedora Toolbox — Hacking on OSTree-based Fedoras
|
2018-09-13 12:17:34 +00:00
|
|
|
|
2018-09-14 09:37:05 +00:00
|
|
|
[Fedora Toolbox](https://github.com/debarshiray/fedora-toolbox) is a tool that
|
|
|
|
|
offers a familiar RPM based environment for developing and debugging software
|
2018-09-14 11:11:53 +00:00
|
|
|
on locked down [OSTree](https://ostree.readthedocs.io/en/latest/) based Fedora
|
2018-09-14 09:37:05 +00:00
|
|
|
systems like [Silverblue](https://silverblue.fedoraproject.org/). Such
|
|
|
|
|
operating systems are shipped as *immutable* OSTree images, where it's
|
|
|
|
|
difficult to setup a development environment with your favorite tools, editors
|
|
|
|
|
and SDKs. A toolbox container solves that problem by providing a RPM based
|
|
|
|
|
*mutable* container. You can tweak it to your heart's content and use DNF to
|
|
|
|
|
install your favorite packages, all without worrying about breaking your
|
|
|
|
|
operating system.
|
2018-09-13 12:17:34 +00:00
|
|
|
|
|
|
|
|
The toolbox environment is based on the `fedora-toolbox` image. This image is
|
|
|
|
|
then customized for the current user to create a toolbox container that
|
|
|
|
|
seamlessly integrates with the rest of the operating system.
|
2018-08-31 16:02:49 +00:00
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
### Create your Fedora Toolbox container:
|
|
|
|
|
```
|
2018-11-12 15:11:33 +00:00
|
|
|
[user@hostname fedora-toolbox]$ fedora-toolbox create
|
2018-08-31 16:02:49 +00:00
|
|
|
[user@hostname fedora-toolbox]$
|
|
|
|
|
```
|
|
|
|
|
This will create a container, and an image, called
|
2018-10-19 14:50:59 +00:00
|
|
|
`fedora-toolbox-<your-username>:<version-id>` that's specifically customised
|
|
|
|
|
for your host user.
|
2018-08-31 16:02:49 +00:00
|
|
|
|
|
|
|
|
### Enter the Toolbox:
|
|
|
|
|
```
|
2018-11-12 15:11:33 +00:00
|
|
|
[user@hostname fedora-toolbox]$ fedora-toolbox enter
|
2018-09-12 14:29:15 +00:00
|
|
|
🔹[user@toolbox ~]$
|
2018-08-31 16:02:49 +00:00
|
|
|
```
|
|
|
|
|
|
