# cotainr
[](https://cotainr.readthedocs.io/en/latest/?badge=latest)
cotainr - a user space [Apptainer](https://apptainer.org/)/[Singularity](https://sylabs.io/singularity/) container builder.
cotainr makes it easy to build Singularity/Apptainer containers for certain use cases.
```shell
cotainr build --base-image docker://ubuntu:24.04 --conda-env <YOUR_CONDA_ENV.yml>
```
## Installation
The recommended way to install cotainr is using pip:
```bash
pip install cotainr
```
Alternatively, you may also simply download, unpack, and run cotainr directly from the `bin/` directory, which is possible since cotainr has no external dependencies other than Python and Singularity/Apptainer.
If you are using EasyBuild for managing your software stack, you may use the `cotainr-easyconfig.eb` EasyConfig as a starting point for installing cotainr via EasyBuild.
## Documentation
The documentation is hosted on [Read the Docs](https://cotainr.readthedocs.io/en/latest/).
## Licensing Information
cotainr is licensed under the European Union Public License (EUPL) 1.2. See the [LICENSE file](https://github.com/DeiC-HPC/cotainr/blob/main/LICENSE) for details.
Your use of cotainr is subject to the terms of the applicable component licenses as listed below. By using cotainr, you agree to fully comply with the terms of these component licenses. If you do not accept these license terms, do not use cotainr.
|Component|License|URL|Cotainr use|
|---------|-------|---|-----------|
|Miniforge|BSD 3-clause|[Miniforge License](https://github.com/conda-forge/miniforge/blob/main/LICENSE)|Miniforge is used to bootstrap conda environments when running `cotainr build --conda-env...`|
Raw data
{
"_id": null,
"home_page": null,
"name": "cotainr",
"maintainer": "DeiC HPC",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "apptainer, conda, container, hpc, singularity",
"author": "Christian Schou Oxvig, Ren\u00e9 L\u00f8we Jacobsen, Eske Christiansen, Joachim S\u00f8dequist, Tor Skovsgaard, Julius Roeder",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/80/2e/5881e735e517d2034c2c483c3fc796f24f8b178c314d75ba08c6f798da48/cotainr-2025.7.1.tar.gz",
"platform": null,
"description": "# cotainr\n\n\n[](https://cotainr.readthedocs.io/en/latest/?badge=latest)\n\ncotainr - a user space [Apptainer](https://apptainer.org/)/[Singularity](https://sylabs.io/singularity/) container builder.\n\ncotainr makes it easy to build Singularity/Apptainer containers for certain use cases.\n\n```shell\ncotainr build --base-image docker://ubuntu:24.04 --conda-env <YOUR_CONDA_ENV.yml>\n```\n\n## Installation\n\nThe recommended way to install cotainr is using pip:\n\n```bash\npip install cotainr\n```\n\nAlternatively, you may also simply download, unpack, and run cotainr directly from the `bin/` directory, which is possible since cotainr has no external dependencies other than Python and Singularity/Apptainer.\n\nIf you are using EasyBuild for managing your software stack, you may use the `cotainr-easyconfig.eb` EasyConfig as a starting point for installing cotainr via EasyBuild.\n\n## Documentation\n\nThe documentation is hosted on [Read the Docs](https://cotainr.readthedocs.io/en/latest/).\n\n## Licensing Information\n\ncotainr is licensed under the European Union Public License (EUPL) 1.2. See the [LICENSE file](https://github.com/DeiC-HPC/cotainr/blob/main/LICENSE) for details.\n\nYour use of cotainr is subject to the terms of the applicable component licenses as listed below. By using cotainr, you agree to fully comply with the terms of these component licenses. If you do not accept these license terms, do not use cotainr.\n\n|Component|License|URL|Cotainr use|\n|---------|-------|---|-----------|\n|Miniforge|BSD 3-clause|[Miniforge License](https://github.com/conda-forge/miniforge/blob/main/LICENSE)|Miniforge is used to bootstrap conda environments when running `cotainr build --conda-env...`|\n",
"bugtrack_url": null,
"license": null,
"summary": "A user space Apptainer/Singularity container builder",
"version": "2025.7.1",
"project_urls": {
"Bug Tracker": "https://github.com/DeiC-HPC/cotainr/issues",
"Changelog": "https://cotainr.readthedocs.io/en/stable/release_notes/index.html",
"Documentation": "https://cotainr.readthedocs.io/en/stable/",
"Repository": "https://github.com/DeiC-HPC/cotainr.git"
},
"split_keywords": [
"apptainer",
" conda",
" container",
" hpc",
" singularity"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6ddade7c33b3e5e164c2a25238e430dda31419bbbe9822246bb8d988f7ab9584",
"md5": "33385b76d2e8b3bf07de1b0a939a156c",
"sha256": "8342e53e86b381dd92d3b6138fd9b6ae6a2e68c8fe099843dd15d078b0b3e302"
},
"downloads": -1,
"filename": "cotainr-2025.7.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "33385b76d2e8b3bf07de1b0a939a156c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 34787,
"upload_time": "2025-07-11T05:33:08",
"upload_time_iso_8601": "2025-07-11T05:33:08.377587Z",
"url": "https://files.pythonhosted.org/packages/6d/da/de7c33b3e5e164c2a25238e430dda31419bbbe9822246bb8d988f7ab9584/cotainr-2025.7.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "802e5881e735e517d2034c2c483c3fc796f24f8b178c314d75ba08c6f798da48",
"md5": "9f6352408585bdf18f907a414025d5e6",
"sha256": "73715cdc49ea82ac33e89de8f7b72800b7527f80c09d0b2962eae0ba61ab95cc"
},
"downloads": -1,
"filename": "cotainr-2025.7.1.tar.gz",
"has_sig": false,
"md5_digest": "9f6352408585bdf18f907a414025d5e6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 95971,
"upload_time": "2025-07-11T05:33:09",
"upload_time_iso_8601": "2025-07-11T05:33:09.186459Z",
"url": "https://files.pythonhosted.org/packages/80/2e/5881e735e517d2034c2c483c3fc796f24f8b178c314d75ba08c6f798da48/cotainr-2025.7.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-11 05:33:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "DeiC-HPC",
"github_project": "cotainr",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cotainr"
}
JSON
