Inicio rápido
Esto te lleva de cero a una instancia en marcha. Necesitas Docker con Compose v2.
1. Obtén los archivos de despliegue
Los archivos de autoalojamiento están en la carpeta deploy/ de la rama next.
git clone --branch next https://github.com/notacamp/campbooks
cd campbooks/deploy
2. Crea tu archivo de ajustes
Copia el ejemplo. Todos los ajustes viven en este único archivo .env.
cp .env.example .env
3. Define los dos valores obligatorios
Abre .env y define al menos estos dos. POSTGRES_PASSWORD debe usar solo caracteres seguros para URL, porque se incrusta en una URL de conexión. openssl rand -hex 24 genera una buena. CAMPBOOKS_PUBLIC_URL es la dirección que la gente usa para llegar a tu instancia. También construye los enlaces de invitación.
POSTGRES_PASSWORD=change-me
CAMPBOOKS_PUBLIC_URL=https://campbooks.example.com
Para una prueba en tu propia máquina, usa http://localhost:8080 como URL pública y añade CAMPBOOKS_ENV=development a .env. El http:// simple solo se acepta en desarrollo. Nunca uses CAMPBOOKS_ENV=development en un servidor al que puedan acceder otras personas: una instalación real usa https:// y deja CAMPBOOKS_ENV sin definir.
4. Inícialo
Esto inicia el servidor y Postgres (con pgvector). El inicio de sesión está integrado en el servidor, así que no hay un servicio aparte para él. En el primer arranque, un servicio puntual genera además la clave secreta de la instancia. Guarda una copia (consulta Actualizaciones y copias de seguridad).
docker compose up -d
5. Comprueba que está sano
El endpoint de salud confirma que el servidor llega a la base de datos.
curl http://localhost:8080/api/v1/system/health
Deberías recibir esto:
{"status":"ok","database":"ok"}
6. Abre la aplicación e inicia sesión
El servidor atiende la aplicación web en el puerto 8080. Si no has iniciado sesión, te envía a la pantalla de inicio de sesión y te devuelve. La gente inicia sesión con Google, Microsoft, Zoho o una llave de acceso. Para ofrecer un proveedor, registra antes su aplicación OAuth (consulta Inicio de sesión).
http://localhost:8080/
7. Crea el primer espacio de trabajo
La primera persona que inicia sesión crea el primer espacio de trabajo. Invita a los demás desde Ajustes, luego Miembros. Las invitaciones aún no se envían por correo: recibes el enlace una sola vez, justo después de invitar, y lo envías tú. Consulta Inicio de sesión para saber quién más puede crear un espacio de trabajo.
Siguientes pasos
- Sírvelo en un dominio real: consulta Inicio de sesión.
- Conecta Gmail o Zoho Mail: consulta Conectar buzones.
- Añade IA local: consulta IA local.
- Lee sobre actualizaciones y copias de seguridad antes de depender de él.