How to Install and Configure Docker on FreeBSD 13

#### Prerequisites Before starting, ensure you have: - A KVM-based NVMe VPS from [EcoStack Cloud](https://ecostack.cloud) running FreeBSD 13. - A user account with sudo privileges. #### Step 1: Install Docker Using the Ports Collection FreeBSD doesn't officially support Docker natively, but you can use the `sysutils/docker` package from the FreeBSD Ports Collection to install Docker. First, update the Ports Collection to ensure you have the latest version of all ports. ```bash sudo portsnap fetch update ``` Navigate to the Docker port directory and install Docker. ```bash cd /usr/ports/sysutils/docker sudo make install clean ``` This process will download and build Docker along with all its dependencies. It may take some time to complete. #### Step 2: Load Docker Kernel Modules For Docker to function properly, you need to load the necessary kernel modules. Add the following lines to your `/boot/loader.conf` to ensure these modules are loaded at boot time: ```bash sudo nano /boot/loader.conf ``` Add the following lines to the file: ```conf linux_load="YES" linux64_load="YES" fdescfs_load="YES" procfs_load="YES" ``` Save and close the file. To load these modules without rebooting, run: ```bash sudo kldload linux sudo kldload linux64 sudo kldload fdescfs sudo kldload procfs ``` Mount the required filesystems: ```bash sudo mount -t fdescfs fdesc /dev/fd sudo mount -t procfs proc /proc ``` #### Step 3: Install and Configure Docker Daemon Download and install the `docker` package from the Ports Collection: ```bash sudo pkg install docker ``` Enable and start the Docker daemon: ```bash sudo sysrc docker_enable="YES" sudo service docker start ``` #### Step 4: Verify Docker Installation Check that Docker is running properly by running a test container: ```bash sudo docker run hello-world ``` This command pulls the `hello-world` image from Docker Hub and runs it in a container. If Docker is installed and configured correctly, you will see a message confirming that Docker is working. #### Step 5: Add Your User to the Docker Group To run Docker commands without `sudo`, add your user to the `docker` group. ```bash sudo pw groupmod docker -m your_username ``` Replace `your_username` with your actual user name. After adding your user to the `docker` group, log out and log back in for the changes to take effect. #### Step 6: Basic Docker Commands Familiarize yourself with some basic Docker commands to get started: - **List Docker Containers**: ```bash docker ps -a ``` This command lists all Docker containers, running and stopped. - **Start a Container**: ```bash docker start container_id ``` Replace `container_id` with the ID or name of your container. - **Stop a Container**: ```bash docker stop container_id ``` Replace `container_id` with the ID or name of your container. - **Remove a Container**: ```bash docker rm container_id ``` Replace `container_id` with the ID or name of the container you wish to remove. - **Pull an Image**: ```bash docker pull image_name ``` Replace `image_name` with the name of the image you want to download from Docker Hub. - **Run a New Container**: ```bash docker run -d -p host_port:container_port image_name ``` Replace `host_port` and `container_port` with the appropriate port numbers, and `image_name` with the desired image name. #### Conclusion For more details and advanced configurations, refer to the [official Docker documentation](https://docs.docker.com/get-started/) and the [FreeBSD Ports documentation](https://www.freebsd.org/ports/).