Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
| install_docker [2024/02/08 18:31] – system | install_docker [2026/09/10 23:34] (current) – [Working with the Docker containers] system | ||
|---|---|---|---|
| Line 7: | Line 7: | ||
| ===== Install Docker ===== | ===== Install Docker ===== | ||
| - | * We assume that you are a user-named **system** on a standard Ubuntu installation. | + | * We assume that you are a user named **system** on a standard Ubuntu |
| - | * Enter the following commands to install the Docker | + | * Set up the Docker repository: |
| + | <code bash> | ||
| + | # Add Docker' | ||
| + | sudo apt update | ||
| + | sudo apt install | ||
| + | sudo install -m 0755 -d / | ||
| + | sudo curl -fsSL https:// | ||
| + | sudo chmod a+r / | ||
| + | |||
| + | # Add the repository to Apt sources: | ||
| + | sudo tee / | ||
| + | Types: deb | ||
| + | URIs: https:// | ||
| + | Suites: $(. / | ||
| + | Components: stable | ||
| + | Architectures: | ||
| + | Signed-By: / | ||
| + | EOF | ||
| + | |||
| + | sudo apt update | ||
| + | </ | ||
| + | * Install | ||
| + | <code bash> | ||
| + | sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin | ||
| + | </ | ||
| + | * Manage Docker as a non-root user: | ||
| <code bash> | <code bash> | ||
| USER=" | USER=" | ||
| + | sudo usermod -aG docker $USER | ||
| + | </ | ||
| + | * After running this, you must log out and log back in //(or run newgrp docker)// for the group changes to take effect. | ||
| + | * Verify the install | ||
| + | <code bash> | ||
| + | docker --version | ||
| + | docker compose version | ||
| + | docker run hello-world | ||
| + | #---- This was the output --- | ||
| + | Unable to find image ' | ||
| + | latest: Pulling from library/ | ||
| + | 4f55086f7dd0: | ||
| + | d5e71e642bf5: | ||
| + | Digest: sha256: | ||
| + | Status: Downloaded newer image for hello-world: | ||
| - | sudo apt-get update | + | Hello from Docker! |
| - | sudo apt-get install -y \ | + | This message shows that your installation appears to be working correctly. |
| - | ca-certificates \ | + | |
| - | curl \ | + | |
| - | gnupg \ | + | |
| - | lsb-release | + | |
| - | sudo curl -fsSL https://download.docker.com/ | + | To generate this message, Docker took the following steps: |
| + | 1. The Docker client contacted the Docker daemon. | ||
| + | 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. | ||
| + | (amd64) | ||
| + | 3. The Docker daemon created a new container from that image which runs the | ||
| + | executable that produces the output you are currently reading. | ||
| + | 4. The Docker daemon streamed that output to the Docker client, which sent it | ||
| + | to your terminal. | ||
| - | echo \ | + | To try something more ambitious, you can run an Ubuntu container with: |
| - | " | + | $ docker |
| - | $(lsb_release -cs) stable" | + | |
| - | sudo apt-get update | + | Share images, automate workflows, and more with a free Docker ID: |
| - | sudo apt-get -y install | + | https:// |
| - | sudo apt-get -y install docker-compose | + | |
| - | # Make docker run as non root | + | For more examples and ideas, visit: |
| - | sudo usermod -aG docker $USER | + | https://docs.docker.com/ |
| - | sudo chmod 666 /var/run/docker.sock | + | |
| - | # customize it with your own. | ||
| - | sudo mkdir -p /mnt/data | ||
| - | # make sure all future data in this folder can be created as non root | ||
| - | sudo chown $USER:$USER /mnt/data | ||
| </ | </ | ||
| + | |||
| + | <WRAP center round tip 100%> | ||
| + | ===== Starting with a clean slate ===== | ||
| + | * You might have some existing docker containers and images that you first want to get rid of. | ||
| + | * **Use these instructions with caution**. It might destroy items you do not want to destroy. | ||
| + | <code bash> | ||
| + | #Only run these commands if you want to start with a full clean slate | ||
| + | docker stop $(docker ps -a -q) | ||
| + | docker rm $(docker ps -a -q) | ||
| + | docker network rm radiusdesk-bridge | ||
| + | </ | ||
| + | </ | ||
| ===== Create the Docker containers ===== | ===== Create the Docker containers ===== | ||
| - | * Everything you need to create the RADIUSdesk Docker containers | + | * Everything you need to create the RADIUSdesk Docker containers |
| * Check out the **rdcore** git repository. | * Check out the **rdcore** git repository. | ||
| <code bash> | <code bash> | ||
| cd ~ | cd ~ | ||
| sudo git clone https:// | sudo git clone https:// | ||
| + | </ | ||
| + | * Check out the **rd_cake5** git repository. | ||
| + | <code bash> | ||
| + | cd ~ | ||
| + | sudo git clone https:// | ||
| </ | </ | ||
| * Mount the rdcore top directory to the **rdcore/ | * Mount the rdcore top directory to the **rdcore/ | ||
| Line 52: | Line 105: | ||
| sudo mount --bind ../ | sudo mount --bind ../ | ||
| </ | </ | ||
| - | * Run the **local_build.sh** script. | + | * Mount the rd_cake5 directory to the **rdcore/ |
| + | <code bash> | ||
| + | sudo mkdir rd_cake5 | ||
| + | sudo mount --bind ../ | ||
| + | </ | ||
| + | * Execute the script | ||
| <code bash> | <code bash> | ||
| ./ | ./ | ||
| Line 71: | Line 129: | ||
| </ | </ | ||
| - | * After it completed | + | * After the process is complete, |
| <code bash> | <code bash> | ||
| docker container ls | docker container ls | ||
| Line 78: | Line 136: | ||
| db3c6fa81d8b | db3c6fa81d8b | ||
| </ | </ | ||
| - | * Open a browser and go to the IP Address | + | * Open a browser and call up the IP address |
| + | |||
| + | ===== Working with the Docker containers ===== | ||
| + | * The docker containers can be seen as a lightweight Linux machine. | ||
| + | ==== Who is active? ==== | ||
| + | |||
| + | * To see which docker containers are running: | ||
| + | <code bash> | ||
| + | docker ps | ||
| + | #This was the reply on my machine | ||
| + | CONTAINER ID | ||
| + | 5c99a3eb667b | ||
| + | 881209d31244 | ||
| + | </ | ||
| + | ==== Shell access ==== | ||
| + | * If you like the Linux shell then you will feel at home inside a Docker container. | ||
| + | * You can shell into the radiusdesk container with the following command: | ||
| + | <code bash> | ||
| + | docker exec -it radiusdesk bash | ||
| + | </ | ||
| + | * To make a backup of the DB you can issue: | ||
| + | <code bash> | ||
| + | mysqldump -h radiusdesk-mariadb -u rd -p --events rd > /tmp/rd.sql | ||
| + | </ | ||
| + | * There are also a vi editor and the ping command installed for basic editing and network troubleshooting. | ||
| + | * To exit out of the docker container simply type **exit**. | ||
| + | * You can shell into the radiusdesk-mariadb container with the following command: | ||
| + | <code bash> | ||
| + | docker exec -it radiusdesk-mariadb bash | ||
| + | </ | ||
| + | ==== Log output ==== | ||
| + | * Again if you like the fact that you can check log files to confirm everything works well then Docker containers got you covered. | ||
| + | * You can run the following command to check the log output of the radiusdesk container: | ||
| + | <code bash> | ||
| + | docker logs radiusdesk --tail 20 -f | ||
| + | </ | ||
| + | * For the log output of radiusdesk-mariadb: | ||
| + | <code bash> | ||
| + | docker logs radiusdesk-mariadb --tail 20 -f | ||
| + | </ | ||