No description
Find a file
Colin Walters efc3553954 Use mutate-os-release
Like we do in FAH, and for the same reasons; it's nice
to have the version field in `/etc/os-release`.
2018-01-19 10:40:37 -05:00
config.ini use download.fp.o to download content from 2016-09-18 21:06:44 -05:00
fedora-ostree-workstation.json Use mutate-os-release 2018-01-19 10:40:37 -05:00
fedora-rawhide.repo Revert "Branching f27 from rawhide" 2017-09-11 10:58:44 -04:00
group Initial commit 2016-04-05 08:39:25 +02:00
passwd Initial commit 2016-04-05 08:39:25 +02:00
post.sh post.sh: Sync with fedora-atomic 2018-01-18 11:56:36 -05:00
README-install-inside.md README: Update for 27, split out install-inside 2017-11-20 10:21:51 -05:00
README.md README: Link to desktop discussion 2017-12-01 16:44:43 -05:00

For some background, see:

(Note also this repo obsoletes https://pagure.io/atomic-ws)

High level design

The goal of the system is to be a workstation, using rpm-ostree for the base OS, and a combination of Docker and Flatpak containers, as well as virtualization tools such as Vagrant.

Status

This project is actively maintained and is ready for use by sophisticated and interested users, but not ready for widespread promotion.

See some [https://lists.fedoraproject.org/archives/list/desktop@lists.fedoraproject.org/thread/J6BJS7Z4NKNOQUZWGYXZZIEKYMWBBSUY/](discussion about the first release).

Installing

There are ISOs available for Fedora 27.

Alternatively, see a guide for installing inside an existing system.

Important issues:

Using the system

One of the first things you should do use is use a container runtime of your choice to manage one or more "pet" containers. This is where you will use yum/dnf to install utilities.

With docker for example, you can use the -v /srv:/srv command line option so these containers can share content with your host (such as git repositories). Note that if you want to share content between multiple Docker containers and the host (e.g. your desktop session), you should execute (once):

sudo chcon -R -h -t container_file_t /var/srv

Next, let's try flatpak. Before you do: There's a known flatpak issue on AtomicWS - run this workaround, which you only need to do once. After that, try flatpak.

If you are a developer for server applications, try oc cluster up to create a local OpenShift v3 cluster.

Finally, try out rpm-ostree install to layer additional packages directly on the host. This is needed for "host extensions" - privileged software that doesn't make sense to live in a container. For example, rpm-ostree install powerline to use that software for the shell prompts of the host. Another good example is rpm-ostree install vagrant-libvirt to use Vagrant to manage VMs.

Future work

  • GNOME Software support for both rpm-ostree/flatpak and possibly docker
  • automated tests that run on this content