mailserver/readme.md

88 lines
3 KiB
Markdown
Raw Normal View History

2024-08-23 07:21:00 +00:00
# Servidor de Correo con Docker 🚀
2024-08-23 07:13:20 +00:00
Este proyecto configura un servidor de correo local utilizando `poste.io` en un contenedor Docker, junto con un contenedor de Fedora personalizado para propósitos adicionales. El proyecto está diseñado para funcionar en un entorno local y es ideal para pruebas y desarrollos internos.
2024-08-23 07:21:00 +00:00
## Estadísticas del Repositorio 📊
2024-08-23 07:13:20 +00:00
2024-08-23 07:21:00 +00:00
![Estado del Proyecto](https://img.shields.io/badge/estado-en%20desarrollo-brightgreen)
![Version](https://img.shields.io/badge/version-1.0.0-blue)
![GitHub stars](https://img.shields.io/github/stars/jmorales01/mailserver)
![GitHub PRs](https://img.shields.io/github/issues-pr/jmorales01/mailserver)
![GitHub forks](https://img.shields.io/github/forks/jmorales01/mailserver)
![GitHub issues](https://img.shields.io/github/issues/jmorales01/mailserver)
2024-08-23 07:13:20 +00:00
2024-08-23 07:21:00 +00:00
## Requisitos Previos 💻
2024-08-23 07:13:20 +00:00
Antes de comenzar, asegúrate de tener instalados los siguientes requisitos:
- [Docker](https://docs.docker.com/get-docker/)
- [Docker Compose](https://docs.docker.com/compose/install/)
2024-08-23 07:21:00 +00:00
## Instrucciones de Ejecución 🛠️
2024-08-23 07:13:20 +00:00
### 1. Clonar el Repositorio
Clona este repositorio en tu máquina local:
```bash
2024-08-23 07:21:00 +00:00
git clone https://github.com/jmorales01/mailserver.git
cd mailserver
2024-08-23 07:13:20 +00:00
```
### 2. Configurar el Archivo hosts
Añade la siguiente línea al archivo `hosts` de tu sistema para poder acceder al servidor de correo mediante un nombre de dominio local:
La IP, tiene que ser la ip de tu dispositivo local que la puedes optener con el comando `ipconfig` en tu CMD.
```bash
192.168.18.4 mail.localdomain
# Ejecuta este comando directo en tu CMD (Windows)
echo 192.168.18.4 mail.localdomain >> C:\Windows\System32\drivers\etc\hosts
```
> **Note:** Asegúrate de que `192.168.18.4` sea la IP local de tu máquina que ejecutará el contenedor, puedes revisarlo con el comando `ipconfig` en tu CMD.
### 3. Construir y Ejecutar los Contenedores
Construye y lanza los contenedores utilizando Docker Compose:
```bash
docker-compose up -d
```
### 4. Acceso a la Interfaz de Administración de `poste.io`
Abre un navegador web y ve a: [**https://mail.localdomain**](https://mail.localdomain/)
## Estructura del Proyecto 🗂️
```text
/path/to/project/
├── Dockerfile # Dockerfile para construir la imagen Fedora
├── docker-compose.yml # Configuración de Docker Compose
├── mail/ # Datos persistentes de poste.io
└── datos/ # Datos compartidos del contenedor Fedora
```
## Donaciones 💰
Si te gusta mi trabajo y quieres apoyarme, ¡considera hacer una donación! Tu apoyo es muy apreciado. 🙏
[![PayPal](https://img.shields.io/badge/PayPal-Donate-blue?style=for-the-badge&logo=paypal)](https://paypal.me/jmoralesv24?country.x=PE&locale.x=es_XC)
## License 📄
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
---
2024-08-23 07:21:00 +00:00
## <div align="center">¡Gracias por visitar mi repositorio 🌟🧑‍💻</div>
2024-08-23 07:13:20 +00:00
---
2024-08-23 07:21:00 +00:00
2024-08-23 07:13:20 +00:00
<div align="center" >
<img src="./public/dashboard.png">
<img src="./public/bandeja.png">
</div>