Update README.md
This commit is contained in:
parent
5c748b4759
commit
88298f6b75
1 changed files with 88 additions and 1 deletions
89
README.md
89
README.md
|
@ -1,2 +1,89 @@
|
||||||
# docker-install-ubuntu-2404
|
# Docker Installation Script for Ubuntu 24.04
|
||||||
|
|
||||||
|
A bash script to automate the installation and configuration of Docker on Ubuntu 24.04 (Noble Numbat).
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- Complete Docker installation (Docker Engine, Docker CLI, Docker Compose)
|
||||||
|
- Automatic removal of old Docker versions
|
||||||
|
- Creates a dedicated Docker user with appropriate permissions
|
||||||
|
- Configures Docker daemon with sensible defaults
|
||||||
|
- Includes error handling and installation checkpoints
|
||||||
|
- Verifies installation with hello-world container
|
||||||
|
- Sets up Docker to start on boot
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
- Ubuntu 24.04 (Noble Numbat)
|
||||||
|
- Root access or sudo privileges
|
||||||
|
- Internet connection
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
1. Clone this repository:
|
||||||
|
```bash
|
||||||
|
git clone https://git.hhf.technology/hhf/docker-install-ubuntu-2404.git
|
||||||
|
cd docker-install-ubuntu
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Make the script executable:
|
||||||
|
```bash
|
||||||
|
chmod +x install-docker.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Run the script:
|
||||||
|
```bash
|
||||||
|
sudo ./install-docker.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
## What the Script Does
|
||||||
|
|
||||||
|
1. Removes any conflicting Docker packages
|
||||||
|
2. Installs necessary prerequisites
|
||||||
|
3. Sets up Docker repository and GPG key
|
||||||
|
4. Installs Docker Engine and related tools
|
||||||
|
5. Creates a dedicated Docker user
|
||||||
|
6. Configures Docker daemon
|
||||||
|
7. Verifies the installation
|
||||||
|
8. Enables Docker service on boot
|
||||||
|
|
||||||
|
## Post-Installation
|
||||||
|
|
||||||
|
After installation:
|
||||||
|
- A new user 'dockeruser' is created and added to the Docker group
|
||||||
|
- You may need to log out and back in for group changes to take effect
|
||||||
|
- Docker daemon is configured with log rotation and default network settings
|
||||||
|
|
||||||
|
## Verification
|
||||||
|
|
||||||
|
To verify the installation:
|
||||||
|
```bash
|
||||||
|
docker --version
|
||||||
|
docker compose version
|
||||||
|
docker run hello-world
|
||||||
|
```
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
The script creates a default daemon configuration at `/etc/docker/daemon.json` with:
|
||||||
|
- Log rotation (max 3 files of 100MB each)
|
||||||
|
- Default address pool configuration
|
||||||
|
- JSON file logging driver
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
- Check the installation logs in `/var/log/docker_install/`
|
||||||
|
- Each step creates a checkpoint file to track progress
|
||||||
|
- The script can be safely re-run if installation fails
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
[MIT License](LICENSE)
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
Feel free to submit issues and pull requests.
|
||||||
|
|
||||||
|
## Contact
|
||||||
|
|
||||||
|
If you have any questions or suggestions, please open an issue in the repository.
|
Loading…
Reference in a new issue