MicroBin

Acceso

Abre la siguiente URL en tu navegador: https://<SERVER-IP>

Acepta el aviso del certificado autofirmado y accede a MicroBin.

Panel de administración

La interfaz de administración está disponible en: https://<SERVER-IP>/admin/

Usa las siguientes credenciales:

• Nombre de usuario: admin
• Contraseña: almacenada en /usr/share/microbin/.env as MICROBIN_ADMIN_PASSWORD

Configuración

Los ajustes de MicroBin se cambian en: /usr/share/microbin/.env

Después de modificar la configuración, reinicia la aplicación:

cd /usr/share/microbin
docker compose up -d

Archivos y directorios importantes

• Ruta de instalación: /usr/share/microbin
• Archivo Compose: /usr/share/microbin/compose.yaml
• Archivo de entorno: /usr/share/microbin/.env
• Volumen de datos: /var/lib/docker/volumes/microbin_microbin_data
• Configuración de Nginx: /etc/nginx/sites-available/microbin

Gestión de servicios

Ver los contenedores en ejecución:

docker compose -f /usr/share/microbin/compose.yaml ps

Reiniciar MicroBin:

docker compose -f /usr/share/microbin/compose.yaml restart

Ver los registros de MicroBin:

cd /usr/share/microbin && docker compose logs -f

Detener MicroBin:

docker compose -f /usr/share/microbin/compose.yaml stop

Inicia MicroBin:

docker compose -f /usr/share/microbin/compose.yaml start

Recrea MicroBin:

docker compose -f /usr/share/microbin/compose.yaml up -d

Comprobar el estado de Nginx:

systemctl status nginx

Reiniciar Nginx:

systemctl restart nginx

Recargar Nginx:

systemctl reload nginx

Valida la configuración de Nginx:

nginx -t

Habilitar HTTPS con un dominio

1. Apunta tu dominio a la IP del servidor.

2. Edita /etc/nginx/sites-available/microbin y reemplaza ambas server_name _; directivas por tu dominio (por ejemplo, server_name yourdomain.com;).

3. Instala Certbot:

apt install -y certbot python3-certbot-nginx

4. Obtén un certificado de Let's Encrypt:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Edita /etc/nginx/sites-available/microbin y actualiza las ssl_certificate y ssl_certificate_key directivas para que usen tu certificado de Let's Encrypt.

Before:
    ssl_certificate /etc/nginx/ssl/microbin.crt;
    ssl_certificate_key /etc/nginx/ssl/microbin.key;
After:
    ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Recargue Nginx para aplicar los cambios:

systemctl reload nginx

7. Edita /usr/share/microbin/.env y actualiza MICROBIN_PUBLIC_PATH desde https://<SERVER_IP>/ por tu dominio (por ejemplo, export MICROBIN_PUBLIC_PATH=https://yourdomain.com/).

8. Recrear los servicios:

cd /usr/sahre/microbin && docker compose up -d

9. Accede a MicroBin en https://yourdomain.com.

Notas

• Volver a crear el servicio puede afectar a las entradas existentes.
• Mantén la .env a salvo, ya que contiene valores de configuración sensibles.