{"id":13929869,"url":"https://github.com/DECODEproject/decode-os","last_synced_at":"2025-07-19T12:30:41.028Z","repository":{"id":41268454,"uuid":"97489092","full_name":"DECODEproject/decode-os","owner":"DECODEproject","description":"The DECODE OS for private, distributed P2P computing","archived":false,"fork":false,"pushed_at":"2022-02-14T15:20:40.000Z","size":624,"stargazers_count":61,"open_issues_count":2,"forks_count":11,"subscribers_count":12,"default_branch":"master","last_synced_at":"2024-11-26T19:36:35.849Z","etag":null,"topics":["devuan","os","sdk"],"latest_commit_sha":null,"homepage":"https://decodeos.dyne.org","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DECODEproject.png","metadata":{"files":{"readme":"README.md","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}},"created_at":"2017-07-17T15:01:08.000Z","updated_at":"2024-08-28T12:30:29.000Z","dependencies_parsed_at":"2022-09-20T23:51:08.926Z","dependency_job_id":null,"html_url":"https://github.com/DECODEproject/decode-os","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DECODEproject/decode-os","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DECODEproject%2Fdecode-os","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DECODEproject%2Fdecode-os/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DECODEproject%2Fdecode-os/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DECODEproject%2Fdecode-os/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DECODEproject","download_url":"https://codeload.github.com/DECODEproject/decode-os/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DECODEproject%2Fdecode-os/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265934185,"owners_count":23852086,"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":["devuan","os","sdk"],"created_at":"2024-08-07T18:02:36.087Z","updated_at":"2025-07-19T12:30:40.715Z","avatar_url":"https://github.com/DECODEproject.png","language":"Shell","readme":"# Operating System for Private and Anonymous Computation Clusters\n\n[![software by Dyne.org](https://www.dyne.org/wp-content/uploads/2015/12/software_by_dyne.png)](http://www.dyne.org)\n\n\u003cdiv class=\"center\"\u003e\n\nThe DECODE operating system is a brand new GNU+Linux distribution\ndesigned to run on servers, embedded computers and virtual machines to\nautomatically connect micro-services to a private and anonymous\npeer-to-peer network cluster.\n\n\u003c/div\u003e\n\n\u003cimg src=\"https://www.dyne.org/wp-content/uploads/2019/12/decode-os_only-logo.png\" class=\"pic\" alt=\"DECODE OS logo\"\u003e\n\n| Features                                   | Components                                                                                                                                                                                                  |\n|--------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Wide compatibility with industry standards | GNU + Linux minimal base                                                                                                                                                                                    |\n| Anonimity and privacy by design            | [Tor](https://torproject.org) hidden service family                                                                                                                                                         |\n| Very secure, restricted environment        | [grsec](https://github.com/minipli/linux-unofficial_grsec/wiki) community fork                                                                                                                              |\n| Customisable to run different applications | [Devuan](https://devuan.org) GNU+Linux SDK                                                                                                                                                                  |\n| Pluggable consensus algorithm              | [Redis](https://redis.io) based consensus broker                                                                                                                                                            |\n| Read-only and authenticated system         | [SquashFS](http://tldp.org/HOWTO/SquashFS-HOWTO/whatis.html) + [overlayfs](https://www.kernel.org/doc/Documentation/filesystems/overlayfs.txt) + [Btrfs](https://btrfs.wiki.kernel.org/index.php/Main_Page) |\n| Integrated updating mechanism              | [Roundshot](https://github.com/DECODEproject/roundshot) initramfs                                                                                                                                           |\n| Built-in Graphical dashboard\t\t     | [Netdata](https://github.com/netdata/netdata) resource monitor                                                                                                                                              |\n| Low power consumption, outdoor usage       | Ports to embedded ARM boards                                                                                                                                                                                |\n| Extensible platform support                | Includes latest JDK, Golang, Python etc.                                                                                                                                                                    |\n| Minimal resource consumption               | Online with less than 64MB of RAM                                                                                                                                                                           |\n\n## For stable releases see \u003ca href=\"https://files.dyne.org/decode\"\u003efiles.dyne.org/decode\u003c/a\u003e\n\n## For more information see \u003ca href=\"https://decodeproject.eu\"\u003ethe DECODE project\u003c/a\u003e\n\nIn particular, the following publications:\n\n- \u003ca href=\"https://decodeproject.eu/publications/privacy-design-strategies-decode-architecture\"\u003ePrivacy Design Strategies for the DECODE Architecture\u003c/a\u003e\n- \u003ca href=\"https://decodeproject.eu/publications/decode-os-first-release\"\u003eDecode OS first release\u003c/a\u003e\n- \u003ca href=\"https://decodeproject.eu/publications/decode-os-software-development-kit\"\u003eDECODE OS Software Development Kit\u003c/a\u003e (soon to be superseeded by the upcoming Devuan's Developer Manual)\n\n## Usage instructions\n\nDECODE OS comes in a variety of flavors:\n\n- for ARM based boxes (embedded)\n- for virtual machines (cloud)\n- live desktop (boot from usb)\n\nRunning systems provide a dashboard by connecting using a browser\nusing HTTP on port 19999.\n\nThe default username is `decode` with password `decode`\n\nThe default `root` password is `toor`.\n\n## Get in touch!\n\nDevelopers of the Dyne.org foundation are available to support\ncustomisations and adaptations of this operating system for particular\npurposes in line with the foundation's goals.\n\nYou are welcome to contact us:\n\n - **#devuan-dev** on **freenode** IRC (public, logged IPs)\n - **#dyne** on \u003ca href=\"https://irc.dyne.org\"\u003eirc.dyne.org\u003c/a\u003e (public and private, no IPs logged)\n - E-mail **info@dyne.org**\n\nThis project is a work in progress proceeding along a clear roadmap\nagreed for the DECODE project. The DECODE OS **stable release is planned\nfor 1st quarter 2019**.\n\n\u003cimg alt=\"Horizon 2020\" src=\"https://zenroom.dyne.org/img/ec_logo.png\" class=\"pic\"\u003e\n\nThis project is receiving funding from the **European Union’s Horizon\n2020 research and innovation programme under grant agreement\nnr. 732546**.\n\n## Build from source\n\nThe following instructions illustrate how one can build DECODE OS from\nscratch, eventually adding software to it. This section is a work in\nprogress.\n\nBuilding can be done from any GNU+Linux distribution, it entails\nbootstrapping a new Devuan base and then customising it via its SDK\nusing a \"blend\", root access is needed in order to operate in `chroot`\nand in KVM accellerated `qemu`.\n\nMore information on this process is provided by the \"Devuan's\nDevelopers Manual\", here is an outline on the steps to be taken.\n\n\n\n### System requirements\n\nA GNU/Linux system is required in order to build DECODE OS.\n\nHere a list of package dependencies:\n```\nzsh sudo cgpt xz-utils qemu qemu-utils\n```\n\nTo clone this repository:\n\n```\ngit clone https://github.com/DECODEproject/os-build-system --recursive\n```\n\nTo update the repository:\n\n```\ngit pull origin master \u0026\u0026 git submodule update --init --recursive --checkout\n```\n\n\n### Building for ARM targets\n\nA more detailed reference for the arm-sdk can be found here: https://git.devuan.org/sdk/arm-sdk\n\n```\ncd arm-sdk # (or vm-sdk or live-sdk depending from your target)\nzsh -f\n./init.sh # and when this is done, execute the command in the bottom of the output\nsource sdk\nload devuan raspi3 decode # (replace \"raspi3\" with your board name, from the list below)\nbootstrap_complete_base\n```\n\nHere is the list of the supported boxes: https://git.devuan.org/sdk/arm-sdk/blob/master/sdk \n\n\n### Building for VM targets\n\n\nTo enter the build console just run `./console.sh`.\n\nTo build a vagrant virtual machine, run `build_vagrant_dist`.\n\nTo build a live iso image, run `build_iso_dist`.\n\nTo build an ARM installer image, run `build_image_dist`.\n\nHere below the sequences of build steps executed by each target:\n\n```sh\nbuild_image_dist() {\n\tbootstrap_complete_base\n\tblend_preinst\n\timage_prepare_raw\n\timage_partition_raw_${parted_type}\n\tbuild_kernel_${arch}\n\tblend_postinst\n\trsync_to_raw_image\n\timage_pack_dist\n}\n\nbuild_iso_dist() {\n\tbootstrap_complete_base\n\tblend_preinst\n\tiso_prepare_strap\n\tbuild_kernel_${arch}\n\tiso_setup_isolinux\n\tiso_write_isolinux_cfg\n\tblend_postinst\n\tfill_apt_cache\n\tiso_squash_strap\n\tiso_xorriso_build\n}\n\nbuild_vagrant_dist() {\n\timage_${imageformat}_as_strapdir\n\tbootstrap_complete_base\n\tvm_inject_overrides\n\tblend_preinst\n\tvm_setup_grub\n\tblend_postinst\n\tvm_umount_${imageformat}\n\tvm_vbox_setup\n\tvm_vagrant_package\n\tvm_pack_dist\n}\n```\n\nThe `build_vagrant_dist` target is a helper that executes a sequence\nof steps, some of them common to other helpers (hence\ncombinable). Here below the full list of build steps executed by\n`build_vagrant_dist`\n\nThe `bootstrap_complete_base` step creates a base system tarball that\ncan be reused by any target, it is found inside `*_sdk/tmp` for each\nsdk and to save time and computation it can be copied in place for\neach sdk if the base system doesn't differ.\n\n## Acknowledgments\n\nDECODE OS is Copyright (c) 2017-2018 by the Dyne.org Foundation\n\nDECODE OS and its core components are designed, written and maintained\nby Denis Roio and Ivan J.\n\nDevuan is a registered trademark of the Dyne.org foundation.\n\nThe Devuan SDK used to build the DECODE OS was originally conceived\nduring a period of residency at the Schumacher college in Dartington,\nUK. Greatly inspired by the laborious and mindful atmosphere of its\nwonderful premises.\n\nDevuan SDK components are designed, written and maintained by Denis\nRoio, Enzo Nicosia and Ivan J.\n\nThis source code is free software: you can redistribute it and/or modify it\nunder the terms of the GNU General Public License as published by the Free\nSoftware Foundation, either version 3 of the License, or (at your option)\nany later version.\n\nThis software is distributed in the hope that it will be useful, but\nWITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY\nor FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for\nmore details.\n\nYou should have received a copy of the GNU General Public License along\nwith this source code. If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n","funding_links":[],"categories":["others"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDECODEproject%2Fdecode-os","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDECODEproject%2Fdecode-os","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDECODEproject%2Fdecode-os/lists"}