{"id":13875843,"url":"https://github.com/johnramsden/zedenv","last_synced_at":"2025-04-09T21:31:51.770Z","repository":{"id":102820995,"uuid":"109555209","full_name":"johnramsden/zedenv","owner":"johnramsden","description":"ZFS Boot Environment manager (new development moved to zectl)","archived":false,"fork":false,"pushed_at":"2020-03-19T01:28:25.000Z","size":347,"stargazers_count":62,"open_issues_count":1,"forks_count":9,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-02T06:37:23.973Z","etag":null,"topics":["freebsd","linux","python","python3","zfs","zfsonlinux"],"latest_commit_sha":null,"homepage":"https://zedenv.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/johnramsden.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-11-05T05:46:28.000Z","updated_at":"2024-02-04T23:58:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"2fd82679-469e-4c17-9905-d5be287fbb34","html_url":"https://github.com/johnramsden/zedenv","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnramsden%2Fzedenv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnramsden%2Fzedenv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnramsden%2Fzedenv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnramsden%2Fzedenv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/johnramsden","download_url":"https://codeload.github.com/johnramsden/zedenv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248114742,"owners_count":21050102,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["freebsd","linux","python","python3","zfs","zfsonlinux"],"created_at":"2024-08-06T06:00:45.602Z","updated_at":"2025-04-09T21:31:51.734Z","avatar_url":"https://github.com/johnramsden.png","language":"Python","funding_links":[],"categories":["Python","python3"],"sub_categories":[],"readme":"======\nzedenv\n======\n\n**Future development has been moved to** `zectl \u003chttps://github.com/johnramsden/zectl\u003e`_\n\n.. image:: https://travis-ci.com/johnramsden/zedenv.svg\n    :target: https://travis-ci.com/johnramsden/zedenv\n\nZFS boot environment manager\n\nDocumentation for the project can be found at `readthedocs \u003chttps://zedenv.readthedocs.io\u003e`_.\n\n``zedenv`` is still experimental and should not be used on production systems.\n\nInstall\n=======\n\n``zedenv`` requires python 3.6+, `pyzfscmds \u003chttps://github.com/johnramsden/pyzfscmds\u003e`_, and ZFS running as the root\nfilesystem.\n\nThe system should also be configured in the format:\n\n.. code:: shell\n\n    ${zpool}/${optional_datasets}/${boot_environment_root}/${root_dataset}\n\nFor example, ``zpool/ROOT/default`` or ``zpool/sys/hostname/ROOT/default``.\n\n``zedenv`` can be installed a few ways:\n\n* From the `setup.py \u003csetup.py\u003e`_ directly.\n* From the `Makefile \u003cpackaging/Makefile\u003e`_.\n* From the `Arch AUR \u003chttps://aur.archlinux.org/packages/zedenv/\u003e`_.\n\nFirst, clone the git repos.\n\n.. code-block:: shell\n\n    git clone https://github.com/johnramsden/pyzfscmds\n    git clone https://github.com/johnramsden/zedenv\n\nMakefile and setup.py\n---------------------\n\nTo install without poluting your system, you can also create a directory somewhere\nand install in a ``venv``, otherwise install to the system.\n\nOptionally, create a ``venv`` and activate.\n\n.. code-block:: shell\n\n    python3.6 -m venv venv\n    . venv/bin/activate\n\nsetup.py\n~~~~~~~~\n\nEnter the repos and install.\n\n.. code-block:: shell\n\n    cd pyzfscmds\n    python setup.py install\n\n    cd ../zedenv\n    python setup.py install\n\nMakefile\n~~~~~~~~\n\nEnter the ``packaging`` directory in the repos run ``make``, ``pyzfscmds`` must\nbe installed first.\n\n.. code-block:: shell\n\n    cd pyzfscmds/packaging\n    make\n\n    cd ../../zedenv/packaging\n    make\n\n\nHow To Use\n----------\n\n\n``zedenv`` can be used to manage boot environments using ZFS. If your system\nis set up in a way compatible with boot environments, you can start using\nthem right away.\n\nCreate and activate a new Boot Environment.\n\n.. code-block:: shell\n\n    $ zedenv create default-0\n    $ zedenv activate default-0\n\nThis will make it the Boot Environment used on reboot.\n\n.. code-block:: shell\n\n    $ zedenv list\n\n.. code-block:: none\n\n    Name       Active   Mountpoint   Creation\n    default    N        -            Wed-May-23-23:48-2018\n    default-0  R        /            Thu-May-24-23:54-2018\n\nThis can be shown with a list, command. The boot environment currently being used will\nhave a 'N' in the active column signifying the boot environment is being used now.\nAn 'R' in the active column means this environment will be used on reboot.\n\nBootloader Plugins\n==================\n\nBootloader plugins are available for:\n\n* Systemd-boot \n* FreeBSD loader \n* GRUB (via `external plugin \u003chttps://github.com/johnramsden/zedenv-grub/\u003e`_)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnramsden%2Fzedenv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnramsden%2Fzedenv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnramsden%2Fzedenv/lists"}