groales/bookstack
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Page: Configuración Inicial
Pages
Actualización Backup y Restauración Configuración Inicial Home NPM Personalización Solución de Problemas Traefik
Clone
2
Configuración Inicial
groales edited this page 2025-12-04 17:26:04 +01:00
Table of Contents

Configuración Inicial

Pasos para configurar BookStack tras el primer despliegue.

Primer Acceso

  1. Accede a BookStack mediante tu dominio configurado
  2. Login con credenciales por defecto:
    • Email: admin@admin.com
    • Password: password

⚠️ CRÍTICO: Estas son credenciales públicas. Cámbialas INMEDIATAMENTE.

Cambiar Contraseña de Admin

  1. Click en tu avatar (esquina superior derecha)
  2. Edit Profile
  3. Change Password
  4. Ingresa contraseña nueva (mínimo 8 caracteres)
  5. Save

Configuración Básica

Settings → Settings

Accede al panel de administración: Settings (engranaje superior derecho)

Información de la Aplicación

  • Application Name: Mi Wiki Corporativa
  • Application Logo: Sube tu logo (PNG/SVG recomendado)
  • Application Icon: Favicon para navegador
  • Default Language: Español (o tu idioma preferido)

Registro y Acceso

Settings → Registration Settings:

  • Allow public registration: ❌ Desactivar
  • Allow public viewing: ✅ Activar si quieres permitir lectura sin login
  • Default role for new users: Viewer (solo lectura)
  • Email confirmation required: ✅ Activar (si tienes SMTP configurado)

Roles y Permisos

Settings → Roles

Roles Por Defecto

BookStack incluye 3 roles:

  1. Admin: Control total del sistema
  2. Editor: Puede crear y editar todo el contenido
  3. Viewer: Solo lectura

Crear Rol Personalizado

  1. Settings → Roles → Create New Role
  2. Role Name: Documentador (ejemplo)
  3. Role Description: Descripción del rol

Permisos del Sistema

  • User management: Gestión de usuarios
  • Manage system settings: Acceso a configuración
  • Manage users, roles & permissions: Gestión de roles
  • Access system API: Acceso a API REST

Permisos de Contenido

Para cada tipo (Books, Chapters, Pages):

  • Create: Crear nuevo contenido
  • Edit Own: Editar su propio contenido
  • Edit All: Editar contenido de otros
  • Delete Own: Eliminar su propio contenido
  • Delete All: Eliminar contenido de otros
  1. Save Role

Crear Usuarios

Settings → Users → Create New User

  1. Name: Nombre completo
  2. Email: email@example.com
  3. Password: Contraseña temporal (el usuario debe cambiarla)
  4. Roles: Seleccionar rol(es)
  5. Send invite email: ✅ Si tienes SMTP configurado
  6. Save

Organizar Contenido

Crear tu Primer Libro

  1. Click en Books (menú superior)
  2. Create New Book
  3. Name: Manual de Usuario
  4. Description: Descripción breve
  5. Cover Image: Imagen de portada (opcional)
  6. Tags: Etiquetas para organización
  7. Save Book

Crear Capítulos

  1. Dentro del libro, click New Chapter
  2. Name: Introducción
  3. Description: Resumen del capítulo
  4. Save Chapter

Crear Páginas

  1. Dentro del capítulo (o libro), click New Page
  2. Name: Primeros Pasos
  3. Selecciona editor:
    • WYSIWYG: Editor visual (como Word)
    • Markdown: Sintaxis Markdown
  4. Escribe contenido
  5. Save Page

Permisos Granulares

Permisos por Libro

  1. Abre el libro
  2. Click en ⋮ → Permissions
  3. Enable Custom Permissions: ✅ Activar
  4. Selecciona roles y sus permisos:
    • View: Ver contenido
    • Edit: Editar contenido
    • Delete: Eliminar contenido
  5. Save Permissions

Permisos por Capítulo/Página

Mismo proceso que libros. Los permisos de nivel superior se heredan, pero pueden sobreescribirse.

Personalización Visual

Settings → Customization

Esquema de Color

  • Color Scheme: Light / Dark
  • Primary Color: Color principal de la interfaz (hex: #0288D1)

HTML Head Personalizado

Añade CSS personalizado:

<style>
  :root {
    --color-primary: #0066cc;
  }
  .header-links {
    background-color: #0066cc;
  }
</style>

Configurar SMTP (Email)

Para enviar emails (invitaciones, notificaciones), configura SMTP mediante variables de entorno.

Añade al .env:

# SMTP Configuration
MAIL_DRIVER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_FROM=bookstack@example.com
MAIL_FROM_NAME="BookStack Wiki"
MAIL_USERNAME=tu@email.com
MAIL_PASSWORD=tu_password_app
MAIL_ENCRYPTION=tls

Reinicia el contenedor:

docker restart bookstack

Prueba el email: Settings → Maintenance → Send a Test Email

Próximos Pasos

  1. Personalización - LDAP, temas avanzados
  2. Backup - Automatiza backups
  3. Crea contenido - Empieza a documentar

BookStack Wiki

🚀 Inicio

📦 Despliegue

⚙️ Configuración

💾 Mantenimiento