README: Note f26 updates situation
[workstation-ostree-config.git] / README.md
1 For some background, see:
2
3  - https://fedoraproject.org/wiki/Workstation/AtomicWorkstation
4  - https://fedoraproject.org/wiki/Changes/WorkstationOstree
5  
6 (Note also this repo obsoletes https://pagure.io/atomic-ws)
7
8 High level design
9 -----------------
10
11 The goal of the system is to be a workstation, using
12 rpm-ostree for the base OS, and a combination of
13 Docker and Flatpak containers, as well as virtualization
14 tools such as Vagrant.
15
16 Status
17 ------
18
19 This project is actively maintained and is ready for use
20 by sophisticated and interested users, but not ready
21 for widespread promotion.
22
23 Updates not currently generated for Fedora 26
24 --------------------------------------------------------
25
26 If you choose Fedora 26, note that Fedora is not currently
27 shipping updates.  For that, see [atomic-ws](https://pagure.io/atomic-ws).
28
29 Installing (do not use partitioning defaults!)
30 ----------
31
32 Important!  *Don't* choose auto-partitioning in the below installer ISO; you
33 currently can't use a separate `/home` partition, and Anaconda defaults to that.
34 This will be fixed in Fedora 27; see
35 this [known issue](https://bugzilla.redhat.com/show_bug.cgi?id=1382873) as
36 well as [this anaconda PR](https://github.com/rhinstaller/anaconda/pull/1124).
37
38 There are ISOs available for [Fedora 26](https://kojipkgs.fedoraproject.org/compose//branched/)
39 [direct link](https://kojipkgs.fedoraproject.org/compose//branched/Fedora-26-20170707.n.0/compose/Workstation/x86_64/iso/Fedora-Workstation-ostree-x86_64-26-20170707.n.0.iso)
40 and [rawhide](https://kojipkgs.fedoraproject.org/compose//rawhide/).
41
42 Important issues:
43 -----------------------
44
45  - [Anaconda autopartitoning](https://github.com/rhinstaller/anaconda/issues/800) - be sure to use `/var/home` instead of `/home`
46  - [flatpak system repo](https://github.com/flatpak/flatpak/issues/113#issuecomment-247022006)
47  
48 Migrating between OSTree repos
49 -------------------------------------
50
51 Enable the 26/27 remotes:
52 ```
53 ostree remote add --if-not-exists --gpg-import /etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-26-primary fedora-ws-26 https://kojipkgs.fedoraproject.org/compose/ostree/26
54 ostree remote add --if-not-exists --gpg-import /etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-27-primary fedora-ws-27 https://kojipkgs.fedoraproject.org/compose/ostree/rawhide
55 ```
56 Rebase to rawhide:
57 ```
58 rpm-ostree rebase fedora-ws-27:fedora/rawhide/x86_64/workstation
59 ```
60  
61 Using the system
62 --------------------
63
64 First, try out `rpm-ostree install` to layer additional packages.  For example,
65 `rpm-ostree install powerline`.
66
67 Next, let's try flatpak. Before you do: There's a known flatpak issue on
68 AtomicWS - run [this workaround](https://github.com/flatpak/flatpak/issues/113#issuecomment-247022006),
69 which you only need to do once. After that, [try flatpak](http://flatpak.org/apps.html).
70
71 If you are a developer for server applications,
72 try [oc cluster up](https://github.com/openshift/origin/blob/master/docs/cluster_up_down.md) to
73 create a local OpenShift v3 cluster.
74
75 Finally, you'll likely want to make one or more "pet" Docker containers,
76 potentially privileged, and use `dnf/yum` inside these. You can use e.g. `-v
77 /srv:/srv` so these containers can share content with your host (such as git
78 repositories). Note that if you want to share content between multiple Docker
79 containers and the host (e.g. your desktop session), you should execute (once):
80
81 ```
82 sudo chcon -R -h -t container_file_t /var/srv
83 ```
84
85 Future work
86 -----------
87
88  - GNOME Software support for both rpm-ostree/flatpak and possibly docker
89  - automated tests that run on this content