{"id":43573557,"url":"https://github.com/projectatomic/container-storage-setup","last_synced_at":"2026-02-03T22:39:07.629Z","repository":{"id":21985428,"uuid":"25310367","full_name":"projectatomic/container-storage-setup","owner":"projectatomic","description":"Service to set up storage for Docker and other container systems","archived":false,"fork":false,"pushed_at":"2019-06-28T07:40:56.000Z","size":482,"stargazers_count":153,"open_issues_count":48,"forks_count":82,"subscribers_count":26,"default_branch":"master","last_synced_at":"2024-05-09T15:33:54.452Z","etag":null,"topics":["containers","docker"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/projectatomic.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":"2014-10-16T16:11:13.000Z","updated_at":"2024-05-09T15:33:54.453Z","dependencies_parsed_at":"2022-08-18T03:11:10.107Z","dependency_job_id":null,"html_url":"https://github.com/projectatomic/container-storage-setup","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/projectatomic/container-storage-setup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectatomic%2Fcontainer-storage-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectatomic%2Fcontainer-storage-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectatomic%2Fcontainer-storage-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectatomic%2Fcontainer-storage-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/projectatomic","download_url":"https://codeload.github.com/projectatomic/container-storage-setup/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projectatomic%2Fcontainer-storage-setup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29060580,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T22:28:58.191Z","status":"ssl_error","status_checked_at":"2026-02-03T22:28:56.515Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["containers","docker"],"created_at":"2026-02-03T22:39:07.555Z","updated_at":"2026-02-03T22:39:07.624Z","avatar_url":"https://github.com/projectatomic.png","language":"Shell","readme":"# Container Storage Setup\n\n## Tool for setting up container runtimes storage\n\n`container-storage-setup` is part of the [Project Atomic](http://www.projectatomic.io/) suite of container projects, formerly known as docker-storage-setup.\n\n\nA crucial aspect to container runtimes is the concept of the copy-on-write (COW) layered filesystems.  The [Docker Engine Storage docs](https://docs.docker.com/engine/userguide/storagedriver/) site explains how the docker daemon uses uses COW file systems\n\n`container-storage-setup` is a script to configure COW File systems like devicemapper and overlayfs.   It is usually run via a systemd service.  For example `docker-storage-setup.service`, runs `container-storage-setup` before the docker.service script starts the docker daemon.\n\nThe `container-storage-service` script takes an input file and an output file as parameters.  The input file is usually provided by the distribution and\nis expected to be modified by administrators. The script generates the specified output file as a configuration file bash script which sets environment variables to be used by the container runtime service script.\n\nFor example if I configured an runtime-storage-setup to look like\n\n```\ncat /etc/sysconfig/runtime-storage-setup \nSTORAGE_DRIVER=\"overlay2\"\n```\n\nIf I then executed\n\n```\ncontainer-storage-setup /etc/sysconfig/runtime-storage-setup  /etc/sysconfig/runtime-storage\n```\n\nI will end up with a runtime storage file which looks like.\n\n```\ncat /etc/sysconfig/runtime-storage\nSTORAGE_OPTIONS=\"--storage-driver overlay2 \"\n```\n\nThe service script of the container runtime should have something like\n\n```\nEnvironmentFile=-/etc/sysconfig/runtime-storage\n...\nExecStart=/usr/bin/container-runtime $STORAGE_OPTIONS\n...\n```\n\nObviously the container runtime must handle the --storage-driver option.\n\nNOTE: `container-storage-setup` has legacy support for docker-storage-setup.  If you execute the script without specifying an input file and and output file, it will default to an input file of `/etc/sysconfig/docker-storage-setup` and an output file of `/etc/sysconfig/docker-storage`.  The Environment name in the output file will be set to DOCKER_STORAGE_OPTIONS.\n\n```\ncat /etc/sysconfig/docker-storage-setup \nSTORAGE_DRIVER=\"overlay2\"\n```\n\nIf I then executed\n\n```\ncontainer-storage-setup\n```\n\nI will end up with a runtime storage file which looks like.\n\n```\ncat /etc/sysconfig/docker-storage\nDOCKER_STORAGE_OPTIONS=\"--storage-driver overlay2 \"\n```\n\n#### Input File \n\nThe input file should be setup by distributions or by the packagers of the\ncontainer runtimes.  The contents can also be set during system\nbootstrap, e.g. in a `cloud-init` `bootcmd:` hook, or via\nkickstart `%post`.\n\n\nFor more information on configuration, see\n[man container-storage-setup](container-storage-setup.1).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojectatomic%2Fcontainer-storage-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprojectatomic%2Fcontainer-storage-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojectatomic%2Fcontainer-storage-setup/lists"}