Saltar para o conteúdo principal

Instalação própria

Corre-o no teu próprio servidor.

Uma imagem e Postgres, com o início de sessão incluído, arrancados com Docker Compose. O teu correio, os teus ficheiros e os teus modelos ficam na tua máquina.

A meio de uma reescrita. O Campbooks está a ser reconstruído de raiz em Rust; esta página cobre a nova versão, que ainda está no início e a avançar depressa (a sincronização do correio e a passagem de IA ainda estão a chegar). A versão antiga em Rails ainda existe, mas é instável, já não é mantida e deixou de receber correções.

  1. CampbooksWeb app and API, one image:8080
  2. PostgresWith pgvector, bundledvolume
  3. Local AIOptional, open-weight models--profile ai
01 / Início rápidoCerca de dez minutos, com o Docker instalado
  1. 01

    Get the deploy files

    Everything you need lives in the deploy folder of the repository.

    git clone --branch next https://github.com/notacamp/campbooks
    cd campbooks/deploy
  2. 02

    Configure

    Copy the example settings, then set a database password and the address people will use.

    cp .env.example .env
    # then edit .env:
    POSTGRES_PASSWORD=change-me
    CAMPBOOKS_PUBLIC_URL=http://localhost:8080
  3. 03

    Start it

    Starts Campbooks (sign-in is built in) and Postgres. Migrations run on startup.

    docker compose up -d
  4. 04

    Check it

    The health check answers once the server and the database are up.

    curl http://localhost:8080/api/v1/system/health
    # {"status":"ok","database":"ok"}
  5. 05

    Open it and sign in

    Go to http://localhost:8080/. The first person to sign in creates the workspace and invites the others from Settings → Members.

    open http://localhost:8080/

Precisas de Docker com Compose v2. Sem IA local, corre à vontade num servidor pequeno; com IA local, os modelos de decisão e pesquisa correm bem em CPU, e a escrita é muito mais rápida numa GPU ou num endpoint de pesos abertos alojado.

02 / IA localOpcional

Os teus modelos, no teu hardware.

O Campbooks usa apenas modelos de pesos abertos, um por tarefa: decidir, escrever, ler e pesquisar. Corre-os ao lado com um só perfil, ou aponta qualquer tarefa para um endpoint compatível com OpenAI em que confies.

Guia de IA local
1 · Define uma chave para o modelo de decisão no .env
openssl rand -hex 32
# CAMPBOOKS_AI__DECIDE__API_KEY=<that value>
2 · Arranca os serviços de IA
docker compose --profile ai up -d
3 · Descarrega o modelo de escrita uma vez
docker compose exec ollama ollama pull qwen3:8b
03 / AtualizaçõesAo teu ritmo

Um comando para atualizar.

Descarrega a nova imagem e reinicia. As migrações da base de dados correm no arranque. Faz primeiro cópia de segurança da base de dados e dos volumes de ficheiros.

Atualizações e cópias de segurança
docker compose pull && docker compose up -d
04 / DocumentaçãoTudo o resto

Preferes que sejamos nós a correr?

A versão alojada está a abrir aos poucos.