{"id":3364,"date":"2024-01-17T02:15:00","date_gmt":"2024-01-17T07:15:00","guid":{"rendered":"https:\/\/www.both.org\/?p=3364"},"modified":"2024-01-13T05:36:28","modified_gmt":"2024-01-13T10:36:28","slug":"how-i-switched-from-docker-desktop-to-colima","status":"publish","type":"post","link":"https:\/\/www.both.org\/?p=3364","title":{"rendered":"How I switched from Docker Desktop to Colima"},"content":{"rendered":"
\r\n
\r\n \r\n <\/i>\r\n <\/a>\r\n <\/span>\r\n<\/div><\/div>\n

Colima is a Docker Desktop alternative for macOS and Linux that’s now supported by DDEV.<\/p>\n\n\n\n

DDEV<\/a> is an open source tool that makes it simple to get local PHP development environments up and running within minutes. It\u2019s powerful and flexible as a result of its per-project environment configurations, which can be extended, version controlled, and shared. In short, DDEV aims to allow development teams to use containers in their workflow without the complexities of bespoke configuration.<\/p>\n\n\n\n

DDEV replaces more traditional AMP stack solutions (WAMP, MAMP, XAMPP, and so on) with a flexible, modern, container-based solution. Because it uses containers, DDEV allows each project to use any set of applications, versions of web servers, database servers, search index servers, and other types of software.<\/p>\n\n\n\n

In March 2022, the DDEV team announced support for C<\/a>olima<\/a>, an open source Docker Desktop replacement for macOS and Linux. Colima<\/a> is open source, and by all reports it\u2019s got performance gains<\/a> over its alternative, so using Colima seems like a no-brainer.<\/p>\n\n\n\n

Migrating to Colima<\/h2>\n\n\n\n

First off, Colima is almost<\/em> a drop-in replacement for Docker Desktop. I say almost<\/em> because some reconfiguration is required when using it for an existing DDEV project. Specifically, databases must be reimported. The fix is to first export your database, then start Colima, then import it. Easy.<\/p>\n\n\n\n

Colima requires that either the Docker or Podman<\/a> command is installed. On Linux, it also requires Lima.<\/p>\n\n\n\n

Docker is installed by default with Docker Desktop for macOS, but it\u2019s also available as a stand-alone command. If you want to go 100% pure Colima, you can uninstall Docker Desktop for macOS, and install and configure the Docker client independently. Full installation instructions can be found on the DDEV docs site<\/a>.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

If you choose to keep using both Colima and Docker Desktop, then when issuing docker commands from the command line, you must first specify which container you want to work with. More on this in the next section.<\/p>\n\n\n\n

Install Colima on macOS<\/h2>\n\n\n\n

I currently have some local projects using Docker, and some using Colima. Once I understood the basics, it\u2019s not too difficult to switch between them.<\/p>\n\n\n\n

    \n
  1. To get started, install Colima using Homebrew brew install colima<\/code><\/li>\n\n\n\n
  2. ddev poweroff<\/code> (just to be safe)<\/li>\n\n\n\n
  3. Next, start Colima with colima start --cpu 4 --memory 4.<\/code> The --cpu<\/code> and --memory<\/code> options only have to be done once. After the first time, only colima start<\/code> is necessary.<\/li>\n\n\n\n
  4. If you\u2019re a DDEV user like me, then you can spin up a fresh Drupal 9 site with the usual ddev<\/code> commands (ddev config, ddev start<\/code>, and so on.) It\u2019s recommended to enable DDEV\u2019s mutagen functionality to maximize performance.<\/li>\n<\/ol>\n\n\n\n

    Switching between a Colima and Docker Desktop<\/h2>\n\n\n\n

    If you\u2019re not ready to switch to Colima wholesale yet, it\u2019s possible to have both Colima and Docker Desktop installed.<\/p>\n\n\n\n

      \n
    1. First, poweroff ddev:ddev poweroff<\/code><\/li>\n\n\n\n
    2. Then stop Colima: colima stop<\/code><\/li>\n\n\n\n
    3. Now run docker context use default<\/code> to tell the Docker client which container you want to work with. The name default<\/code> refers to Docker Desktop for Mac. When colima start<\/code> is run, it automatically<\/em> switches Docker to the colima<\/code> context.<\/li>\n\n\n\n
    4. To continue with the default (Docker Desktop) context, use the ddev start<\/code> command.<\/li>\n<\/ol>\n\n\n\n

      Technically, starting and stopping Colima isn\u2019t necessary, but the ddev poweroff <\/code>command when switching between two contexts is.<\/p>\n\n\n\n

      Recent versions of Colima revert the Docker context back to default<\/code> when Colima is stopped, so the docker context use default<\/code> command is no longer necessary. Regardless, I still use docker context show<\/code> to verify that either the default<\/code> (Docker Desktop for Mac) or colima<\/code> context is in use. Basically, the term context<\/code> refers to which container provider the Docker client routes commands to.<\/p>\n\n\n\n

      Try Colima<\/h2>\n\n\n\n

      Overall, I\u2019m liking what I see so far. I haven\u2019t run into any issues, and Colima-based sites seem a bit snappier (especially when DDEV\u2019s Mutagen functionality is enabled). I definitely foresee myself migrating project sites to Colima over the next few weeks.<\/p>\n\n\n\n

      This article originally appeared on the<\/em> DrupalEasy blog<\/em><\/a> and is republished with permission.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"

      Colima is a Docker Desktop alternative for macOS and Linux that’s now supported by DDEV.<\/p>\n","protected":false},"author":92,"featured_media":3365,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_lmt_disableupdate":"","_lmt_disable":"","footnotes":""},"categories":[214],"tags":[215,217],"class_list":["post-3364","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-macos","tag-colima","tag-docker-desktop"],"modified_by":"David Both","_links":{"self":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/3364","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/users\/92"}],"replies":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3364"}],"version-history":[{"count":3,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/3364\/revisions"}],"predecessor-version":[{"id":3672,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/3364\/revisions\/3672"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/media\/3365"}],"wp:attachment":[{"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3364"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=3364"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=3364"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}