Assistela Docker

Seu próprio servidor ou NAS

Execute o Assistela no seu próprio servidor Linux ou em um NAS compatível, com interface no navegador e o Client gratuito para iOS.

Chat, memória, arquivos, ferramentas e integrações são grátis. O Assistela Pro acrescenta o Assistente Pessoal e o Agendador. O Assistela Client é grátis.

O que você precisa

Linux ARM64 ou AMD64 com Docker Engine e Docker Compose.
Armazenamento persistente e gravável para o espaço de trabalho, configurações e backups.
Um endpoint de modelo de IA acessível pelo contêiner.
Uma conexão com a internet para serviços de conta e emparelhamento de dispositivos.

IA local ou hospedada

Conecte o LM Studio ou um servidor de modelos compatível com OpenAI, ou escolha um provedor de IA compatível. O modelo roda separadamente do Assistela; eventuais tarifas do provedor não fazem parte do Pro.

Use um endereço de modelo acessível pelo Docker. Localhost dentro de um contêiner se refere àquele contêiner, não ao computador que executa seu modelo.

Seus dados, seu host

O Docker armazena o espaço de trabalho em um volume persistente /data no seu host. Faça backup desse volume e mantenha o host disponível. Os dados necessários a uma solicitação podem ser enviados ao provedor de IA escolhido.

Diferenças entre plataformas

O Docker oferece integrações de servidor e um navegador Chromium. Ele não controla aplicativos do Mac nem acessa diretamente Apple Mail, iMessage ou calendários e contatos locais da Apple.

Instalação e primeira conexão

Baixe a imagem pronta para uso no GitHub. O Docker seleciona ARM64 ou AMD64 automaticamente. Não é necessário ter o código-fonte Swift nem um compilador.

ghcr.io/assistela/assistela:2.0.29

Docker Compose

Salve este conteúdo como compose.yaml e execute os comandos abaixo nessa pasta. Este exemplo só pode ser acessado no host do Docker.

Baixar compose.yaml

name: assistela-docker-v2
services:
  assistela:
    image: ghcr.io/assistela/assistela:2.0.29
    hostname: assistela-docker-v2
    init: true
    restart: unless-stopped
    stop_grace_period: 120s
    shm_size: 512mb
    ports:
      - "127.0.0.1:8234:8234"
    environment:
      ASSISTELA_PUBLIC_URL: http://localhost:8234
      ASSISTELA_TIME_ZONE: Europe/Prague
    volumes:
      - assistela-data:/data
    security_opt:
      - no-new-privileges:true
volumes:
  assistela-data:

docker compose pull
docker compose up -d
docker compose logs assistela

http://localhost:8234/admin/

Após a instalação, abra a interface administrativa no host Docker, use o token de configuração dos logs do contêiner e escolha uma senha de administrador. Depois, conecte seu modelo de IA e emparelhe o Client para iOS com um código QR.

Synology Container Manager

Em um NAS Synology compatível, abra Container Manager → Projeto → Criar. Escolha uma pasta, cole o YAML abaixo no editor e inicie o projeto.

Substitua NAS_IP nos dois locais pelo endereço IPv4 privado do NAS, por exemplo 192.168.1.10. Abra http://NAS_IP:8234/admin/ e encontre o token de configuração nos logs do contêiner.

Configuração recomendada para Synology, testada com user: "1026:100". Crie primeiro /volume1/docker/assistela e defina user como o UID:GID do proprietário da pasta; confira os IDs da sua conta com id via SSH. Ajuste o caminho da pasta se necessário.

Baixar compose.yaml para Synology

name: assistela
services:
  assistela:
    image: ghcr.io/assistela/assistela:2.0.29
    user: "1026:100"
    hostname: assistela
    init: true
    restart: unless-stopped
    stop_grace_period: 120s
    shm_size: 512mb
    ports:
      - "NAS_IP:8234:8234"
    environment:
      ASSISTELA_PUBLIC_URL: http://NAS_IP:8234
      ASSISTELA_ALLOW_LAN_HTTP: "1"
      ASSISTELA_TIME_ZONE: Europe/Prague
    volumes:
      - /volume1/docker/assistela:/data
    security_opt:
      - no-new-privileges:true

O exemplo do Synology usa HTTP sem criptografia na sua rede local confiável. Para acesso pela internet, use um proxy reverso HTTPS e defina ASSISTELA_PUBLIC_URL com o endereço exato dele.

Synology — Container Manager / Project

Atualizações e backups

Os dados permanecem no armazenamento montado em /data: o volume do Docker ou a pasta do NAS. Mantenha inalterados o mapeamento do armazenamento, o nome do projeto e o nome do host. Faça backup de /data antes de atualizar; nunca exclua seu conteúdo.

Para atualizar, altere a tag da imagem para a nova versão e execute pull e up -d novamente. No Container Manager, edite o YAML e implante o projeto novamente.

Fale conosco sobre a instalação do Docker All pricing details