{"id":13393584,"url":"https://github.com/boot2docker/boot2docker","last_synced_at":"2025-09-28T19:32:09.872Z","repository":{"id":12300340,"uuid":"14930729","full_name":"boot2docker/boot2docker","owner":"boot2docker","description":"DEPRECATED; see https://github.com/boot2docker/boot2docker/pull/1408","archived":true,"fork":false,"pushed_at":"2020-06-30T17:55:50.000Z","size":1495,"stargazers_count":8330,"open_issues_count":335,"forks_count":1285,"subscribers_count":385,"default_branch":"master","last_synced_at":"2025-01-17T04:12:31.443Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/boot2docker/boot2docker/pull/1408","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/boot2docker.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":"2013-12-04T17:26:57.000Z","updated_at":"2025-01-09T20:33:03.000Z","dependencies_parsed_at":"2022-08-07T06:16:53.334Z","dependency_job_id":null,"html_url":"https://github.com/boot2docker/boot2docker","commit_stats":null,"previous_names":[],"tags_count":245,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boot2docker%2Fboot2docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boot2docker%2Fboot2docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boot2docker%2Fboot2docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boot2docker%2Fboot2docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boot2docker","download_url":"https://codeload.github.com/boot2docker/boot2docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234555961,"owners_count":18851879,"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":[],"created_at":"2024-07-30T17:00:56.423Z","updated_at":"2025-09-28T19:32:04.543Z","avatar_url":"https://github.com/boot2docker.png","language":"Shell","readme":"# DEPRECATED\n\nBoot2Docker is officially deprecated and unmaintained.  It is recommended that users transition from Boot2Docker over to [Docker Desktop](https://www.docker.com/products/docker-desktop) instead (especially with [the new WSL2 backend, which supports Windows 10 Home](https://www.docker.com/blog/docker-desktop-for-windows-home-is-here/)).\n\nThese days there are a *lot* of tools designed to help spin up environments, and it's relatively easy to get something up and running with Docker installed with minimal effort.\n\n# Boot2Docker\n\n[![Build Status](https://travis-ci.org/boot2docker/boot2docker.svg?branch=master)](https://travis-ci.org/boot2docker/boot2docker)\n\nBoot2Docker is a lightweight Linux distribution made specifically to run\n[Docker](https://www.docker.com/) containers. It runs completely from RAM, is a\n~45MB download and boots quickly.\n\n## Features\n\n* Recent Linux Kernel, Docker pre-installed and ready-to-use\n* VM guest additions (VirtualBox, Parallels, VMware, XenServer)\n* Container persistence via disk automount on `/var/lib/docker`\n* SSH keys persistence via disk automount\n\n\u003e **Note:** Boot2Docker uses port **2376**, the [registered IANA Docker TLS\n\u003e port](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml?search=docker)\n\n## Caveat Emptor\n\nBoot2Docker is designed and tuned for development.\n**Using it for any kind of production workloads is highly discouraged.**\n\n## Installation\n\nInstallation should be performed via [Docker Toolbox](https://docs.docker.com/toolbox/)\nwhich installs [Docker Machine](https://docs.docker.com/machine/overview/), \nthe Boot2Docker VM, and other necessary tools.\n\nThe [ISO can be downloaded\nhere](https://github.com/boot2docker/boot2docker/releases).\n\n## How to use\n\nBoot2Docker is used via [Docker Machine](https://docs.docker.com/machine/overview/) \n(installed as part of Docker Toolbox) which leverages VirtualBox's `VBoxManage` to\ninitialise, start, stop and delete the VM right from the command line.\n\n## More information\n\nSee [Frequently asked questions](FAQ.md) for more details.\n\n#### Boot script log\n\nThe bootup script output is logged to `/boot.log`, so you can see (and\npotentially debug) what happens. Note that this is not persistent between boots\nbecause we're logging from before the persistence partition is mounted (and it\nmay not exist at all).\n\n#### Docker daemon options\n\nIf you need to customize the options used to start the Docker daemon, you can\ndo so by adding entries to the `/var/lib/boot2docker/profile` file on the\npersistent partition inside the Boot2Docker virtual machine. Then restart the\ndaemon.\n\nThe following example will enable core dumps inside containers, but you can\nspecify any other options you may need.\n\n```console\ndocker-machine ssh default -t sudo vi /var/lib/boot2docker/profile\n# Add something like:\n#     EXTRA_ARGS=\"--default-ulimit core=-1\"\ndocker-machine restart default\n```\n\n#### Installing secure Registry certificates\n\nAs discussed in the [Docker Engine documentation](https://docs.docker.com/engine/security/certificates/#/understanding-the-configuration)\ncertificates should be placed at `/etc/docker/certs.d/hostname/ca.crt` \nwhere `hostname` is your Registry server's hostname.\n\n```console\ndocker-machine scp certfile default:ca.crt\ndocker-machine ssh default\nsudo mv ~/ca.crt /etc/docker/certs.d/hostname/ca.crt\nexit\ndocker-machine restart\n```\n\nAlternatively the older Boot2Docker method can be used and you can add your \nRegistry server's public certificate (in `.pem` or `.crt` format) into\nthe `/var/lib/boot2docker/certs/` directory, and Boot2Docker will automatically\nload it from the persistence partition at boot.\n\nYou may need to add several certificates (as separate `.pem` or `.crt` files) to this\ndirectory, depending on the CA signing chain used for your certificate.\n\n##### Insecure Registry\n\nAs of Docker version 1.3.1, if your registry doesn't support HTTPS, you must add it as an\ninsecure registry.\n\n```console\n$ docker-machine ssh default \"echo $'EXTRA_ARGS=\\\"--insecure-registry \u003cYOUR INSECURE HOST\u003e\\\"' | sudo tee -a /var/lib/boot2docker/profile \u0026\u0026 sudo /etc/init.d/docker restart\"\n```\n\nthen you should be able to do a docker push/pull.\n\n#### Running behind a VPN (Cisco AnyConnect, etc)\n\nSo sometimes if you are behind a VPN, you'll get an `i/o timeout` error.\nThe current work around is to forward the port in the boot2docker-vm.\n\nIf you get an error like the following:\n\n```no-highlight\nSending build context to Docker daemon\n2014/11/19 13:53:33 Post https://192.168.59.103:2376/v1.15/build?rm=1\u0026t=your-tag: dial tcp 192.168.59.103:2376: i/o timeout\n```\n\nThat means you have to forward port `2376`, which can be done like so:\n\n* Open VirtualBox\n* Open Settings \u003e Network for your 'default' VM\n* Select the adapter that is 'Attached To': 'NAT' and click 'Port Forwarding'.\n* Add a new rule:\n\t- Protocol: TCP\n\t- Host IP: 127.0.0.1\n\t- Host Port: 5555\n\t- Guest Port: 2376\n* Set `DOCKER_HOST` to 'tcp://127.0.0.1:5555'\n\n#### SSH into VM\n\n```console\n$ docker-machine ssh default\n```\n\nDocker Machine auto logs in using the generated SSH key, but if you want to SSH\ninto the machine manually (or you're not using a Docker Machine managed VM), the\ncredentials are:\n\n```\nuser: docker\npass: tcuser\n```\n\n#### Persist data\n\nBoot2docker uses [Tiny Core Linux](http://tinycorelinux.net), which runs from\nRAM and so does not persist filesystem changes by default.\n\nWhen you run `docker-machine`, the tool auto-creates a disk that\nwill be automounted and used to persist your docker data in `/var/lib/docker`\nand `/var/lib/boot2docker`.  This virtual disk will be removed when you run\n`docker-machine delete default`.  It will also persist the SSH keys of the machine.\nChanges outside of these directories will be lost after powering down or\nrestarting the VM.\n\nIf you are not using the Docker Machine management tool, you can create an `ext4`\nformatted partition with the label `boot2docker-data` (`mkfs.ext4 -L\nboot2docker-data /dev/sdX5`) to your VM or host, and Boot2Docker will automount\nit on `/mnt/sdX` and then softlink `/mnt/sdX/var/lib/docker` to\n`/var/lib/docker`.\n","funding_links":[],"categories":["enviroment","Shell","Development with Docker","Local Container Manager","others"],"sub_categories":["Development Environment"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboot2docker%2Fboot2docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboot2docker%2Fboot2docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboot2docker%2Fboot2docker/lists"}