How to Change the Default Storage Location in ONLYOFFICE Workspace

Short answer: in ONLYOFFICE Workspace, the Control Panel can move portal static data away from the default local disk to a supported third-party storage service. The current official administration guide lists Amazon S3, Google Cloud Storage, Rackspace Cloud Storage, and Selectel Cloud Storage for this purpose. It does not describe a Control Panel field where you can type an arbitrary local path such as /mnt/storage.

This guide uses a clearly hypothetical example throughout. Imagine a small design agency called Northstar Studio. Its self-hosted ONLYOFFICE Workspace server is running out of local disk space because uploaded files and other portal static data have grown steadily. The administrator wants to move that portal storage to an Amazon S3 bucket while keeping the Workspace portal itself on the same server. Northstar Studio is only an illustration, not a real test or customer result.

Before changing anything, it helps to distinguish two different tasks that are often described as “changing the default storage location.” The first is switching the portal’s static-data storage from the local disk to a supported object-storage provider in the Control Panel. The second is moving the host filesystem directory used by a self-hosted Docker installation. ONLYOFFICE documents these as different layers, so the steps below focus first on the supported Control Panel method and then explain the local-disk case separately.

What changes when you select a new storage provider?

By default, ONLYOFFICE Workspace stores portal data on the local disk of the machine where Workspace is installed. The official Storage page says a connected third-party service can be used for static portal data. After you choose and connect a new provider, the page reloads and a data migration process starts. Depending on the amount of data, that migration can take time.

For Northstar Studio, the goal is therefore not “make every user save future documents into a particular folder.” It is “move the portal’s storage backend from Disk Default to the S3 bucket.” That distinction matters because user folder organization, connected third-party folders inside the Documents module, backup destinations, and the administrator-level Storage backend are separate features.

Official reference: ONLYOFFICE Help Center: Connecting third-party storages.

Step 1: Back up the portal before changing storage

A storage change starts a migration, so create a recoverable backup first. ONLYOFFICE provides backup and restore controls in the Control Panel. A backup can be stored temporarily, in the Documents module, on a computer path, or in supported third-party storage depending on the deployment and configuration.

Para o hipotético servidor Northstar Studio, o administrador faria um novo backup e confirmaria onde o arquivo resultante está armazenado antes de acessar a página de Armazenamento. Isso não garante que uma migração falhará; simplesmente fornece ao administrador um caminho de recuperação caso as credenciais, a política do bucket, o acesso à rede ou outra dependência estejam incorretas.

Referência oficial: Central de Ajuda do ONLYOFFICE: Backup e restauração do Painel de Controle .

Passo 2: Abra o Painel de Controle e verifique a integração.

Faça login com uma conta que possa administrar o portal. Na página inicial do Workspace, abra o Painel de Controle ou abra as Configurações do portal e siga o link Painel de Controle na área lateral esquerda. O serviço de terceiros deve primeiro ser conectado na seção Integração do portal; caso contrário, a opção de armazenamento será desativada na página Armazenamento.

Ilustração da interface do espaço de trabalho ONLYOFFICE mostrando as Configurações com a entrada do Painel de Controle usada para acessar a administração do portal.
Ilustração da interface do espaço de trabalho ONLYOFFICE mostrando as Configurações com a entrada do Painel de Controle usada para acessar a administração do portal.

A Northstar Studio planeja usar o Amazon S3, portanto, o administrador primeiro verifica se o Amazon S3 está configurado como um serviço de terceiros. O mesmo pré-requisito se aplica ao escolher o Google Cloud Storage, o Rackspace Cloud Storage ou o Selectel Cloud Storage.

Ilustração da integração do painel de controle listando Amazon S3, Google Cloud Storage, Rackspace Cloud Storage e Selectel Cloud Storage como integrações de armazenamento.
Ilustração da integração do painel de controle listando Amazon S3, Google Cloud Storage, Rackspace Cloud Storage e Selectel Cloud Storage como integrações de armazenamento.

Passo 3: Abra Configurações comuns → Armazenamento

No Painel de Controle, acesse a página Armazenamento em Configurações Comuns . A opção Disco Padrão está selecionada inicialmente. É aqui que você escolhe qual servidor de armazenamento compatível deve conter os dados estáticos do portal.

Ilustração do Painel de Controle de Armazenamento com o Disco Padrão selecionado e as quatro opções de armazenamento de terceiros documentadas visíveis.
Ilustração do Painel de Controle de Armazenamento com o Disco Padrão selecionado e as quatro opções de armazenamento de terceiros documentadas visíveis.

Se você deseja apenas manter os dados no disco local do servidor, não selecione um provedor de nuvem. A opção "Disco Padrão" continua sendo a escolha para armazenamento local. Se sua necessidade real é mover esses dados locais para um ponto de montagem diferente no mesmo servidor, pule para a seção sobre Docker e caminhos de host abaixo; a página "Armazenamento" não é um seletor genérico de caminho de sistema de arquivos.

Passo 4: Insira as configurações específicas do provedor.

Selecione o provedor que deseja usar e preencha os detalhes de conexão necessários. Para o Amazon S3, a documentação atual do ONLYOFFICE descreve campos como Bucket e Região, além de opções como URL do Serviço, Forçar Estilo de Caminho, Usar HTTP e configurações relacionadas à criptografia. O Google Cloud Storage usa um nome de bucket; Rackspace e Selectel usam seus próprios campos de contêiner e região.

Ilustração da configuração de armazenamento do Amazon S3 mostrando o bucket, a região, a URL do serviço (opcional), o estilo do caminho, o HTTP e as configurações de criptografia antes da conexão.
Ilustração da configuração de armazenamento do Amazon S3 mostrando o bucket, a região, a URL do serviço (opcional), o estilo do caminho, o HTTP e as configurações de criptografia antes da conexão.

No exemplo do Northstar Studio, o administrador inseriria um bucket S3 dedicado e a região AWS correta. Ele deixaria o URL do serviço inalterado, a menos que precisasse intencionalmente de um endpoint diferente. As credenciais e permissões devem ser limitadas ao necessário para o Workspace, e o acesso à rede do servidor para o serviço de armazenamento deve ser verificado antes de iniciar a migração.

Verificações práticas antes de clicar em Conectar

  • Confirme se o bucket ou contêiner existe na região esperada.
  • Confirme se as credenciais de integração são válidas e autorizadas para as operações de objeto necessárias.
  • Confirme se o servidor do Workspace consegue alcançar o endpoint do provedor.
  • Mantenha o backup mais recente disponível fora da pasta onde os dados estão sendo migrados.
  • Agende a alteração para um período em que você possa monitorar o portal e o serviço de armazenamento em busca de erros ou uso inesperado da capacidade.

Etapa 5: Conecte o armazenamento e deixe a migração terminar.

Clique em Conectar . De acordo com o guia oficial da ONLYOFFICE, a página será recarregada e o processo de migração de dados será iniciado. Não presuma que a alteração esteja concluída apenas porque o provedor foi aceito. Aguarde até que a página de Armazenamento retorne com o novo armazenamento selecionado e, em seguida, verifique o uso normal do portal.

Ilustração de armazenamento mostrando o Amazon S3 selecionado após a configuração, com o bucket e a região escolhidos resumidos.
Ilustração de armazenamento mostrando o Amazon S3 selecionado após a configuração, com o bucket e a região escolhidos resumidos.

Para o Northstar Studio, uma validação sensata incluiria abrir vários documentos existentes, carregar um novo arquivo, visualizar imagens ou outros conteúdos estáticos e verificar o bucket S3 em busca de novos objetos. O layout exato do objeto é um detalhe de implementação; o importante é que o conteúdo do portal funcione normalmente e que o novo backend esteja sendo utilizado. Se o portal reportar erros, investigue as credenciais, a política do bucket, a região, a acessibilidade do endpoint e os logs do servidor antes de fazer alterações adicionais.

E se você quiser um disco local ou ponto de montagem diferente?

É aqui que muitos tutoriais sobre "local de armazenamento padrão" se tornam enganosos. A opção "Disco Padrão" do Painel de Controle não permite selecionar um diretório arbitrário no host. Para implantações do Workspace baseadas em Docker, a própria documentação de migração da ONLYOFFICE afirma que os dados do portal são armazenados /app/onlyofficeno host. A documentação de instalação manual do Docker também cria diretórios de componentes abaixo dessa árvore, como CommunityServer, DocumentServer, MailServer, ControlPanel e diretórios relacionados ao banco de dados.

Se precisar mover esses diretórios do lado do host para um disco maior, trate isso como uma migração de implantação, e não como uma configuração do Painel de Controle. Faça backup da instalação, pare os contêineres relevantes, copie os dados preservando a propriedade e as permissões, atualize os bind mounts ou as definições de volume do Docker Compose usadas pela sua implantação específica e só então reinicie o sistema. O arquivo Compose exato e o mapeamento de volumes dependem de como o Workspace foi instalado; portanto, copiar um comando genérico de outra implantação pode quebrar o portal.

Para instalações com Docker Compose, consulte os arquivos de implantação que você utiliza atualmente e compare-os com o guia de instalação oficial: Instalando o ONLYOFFICE Workspace Community usando o Docker Compose . Para obter informações sobre a localização dos dados do host usada pelo layout oficial do Workspace baseado em Docker, consulte o guia de migração do ONLYOFFICE Workspace para Docker .

Qual a diferença entre alterar o armazenamento do portal e alterar o armazenamento de backup?

São opções distintas. A página Armazenamento determina onde os dados estáticos do portal são armazenados. A página Backup determina onde os arquivos de backup são gravados. Você pode, por exemplo, manter os dados do portal no Disco Padrão enquanto grava os backups em outro local, ou mover os dados estáticos do portal para o S3 enquanto mantém os backups em outro local. Para garantir a resiliência, manter os backups logicamente separados do backend de armazenamento primário geralmente facilita o processo de recuperação.

Qual opção se adequa melhor à sua situação?

MetaUsarLimitação principal
Mover dados estáticos do portal do disco local para armazenamento em nuvem/objetos compatível.Painel de Controle → Configurações Comuns → ArmazenamentoSomente os provedores documentados estão disponíveis nesta interface.
Mantenha os dados no disco do servidor local.Disco padrãoNão há documentação sobre como selecionar caminhos locais arbitrários no Painel de Controle.
Mova os dados do Docker auto-hospedado para outro disco ou ponto de montagem do host.Alteração de volume/montagem vinculada no nível de implantaçãoOs caminhos exatos dependem do método de instalação; faça um backup primeiro.
Alterar o local onde os arquivos de backup são salvos.Painel de Controle → BackupIsso não altera o backend de armazenamento principal do portal.

Lista de verificação final

  • O provedor desejado é selecionado na página de Armazenamento.
  • A migração terminou, e não apenas começou.
  • Os arquivos existentes abrem e são baixados normalmente.
  • Novos uploads funcionam.
  • Os usuários ainda podem acessar o portal sem erros relacionados ao armazenamento.
  • O novo bucket ou contêiner mostra atividade consistente com o uso do portal.
  • Um backup recente permanece disponível e não foi armazenado acidentalmente apenas no conjunto de dados que você acabou de mover.

No exemplo do Northstar Studio, a alteração de armazenamento só é considerada bem-sucedida quando o portal se comporta normalmente após a migração e o administrador confirma que o backend S3 selecionado está ativo. Essa definição prática é mais útil do que considerar o próprio botão "Conectar" como prova de que a tarefa foi concluída.

Deixar um comentário

O que é o Microsoft Access? Como funcionam suas ferramentas de banco de dados?

O que é o Microsoft Access? Como funcionam suas ferramentas de banco de dados?

O Microsoft Access é um aplicativo de banco de dados para Windows que permite armazenar registros relacionados, criar consultas, elaborar formulários de entrada de dados e gerar relatórios. Saiba como ele funciona e quando é adequado para você.

Alterar a altura e a largura das linhas de grade no Word 2010

Alterar a altura e a largura das linhas de grade no Word 2010

Aprenda como ajustar a altura e a largura das linhas de grade no Word 2010, alterar a frequência das linhas visíveis e definir o espaçamento horizontal e vertical da grade de desenho subjacente.

Importação e exportação do Office Outlook 2010: Mova dados com um arquivo PST

Importação e exportação do Office Outlook 2010: Mova dados com um arquivo PST

Aprenda como importar um arquivo PST para o Outlook 2010 ou exportar emails, contatos, calendário e tarefas. Siga os menus corretos e evite pastas ausentes ou duplicadas.

Recupere a senha de um arquivo PST do Outlook com o Nucleus Kernel

Recupere a senha de um arquivo PST do Outlook com o Nucleus Kernel

Recupere uma senha esquecida de um arquivo PST do Outlook seguindo os passos atuais do Kernel, incluindo como identificar o arquivo correto, fazer um backup e verificar as limitações da ferramenta.

Como inserir uma página da web em um slide do PowerPoint

Como inserir uma página da web em um slide do PowerPoint

Use o suplemento LiveWeb para inserir um site em um slide do PowerPoint, definir seu tamanho e comportamento de atualização e verificar a compatibilidade antes da apresentação.

Contatos do Outlook 2010: Adicionar pessoas e usar a agenda de endereços

Contatos do Outlook 2010: Adicionar pessoas e usar a agenda de endereços

Aprenda como criar e organizar contatos no Outlook 2010, criar um grupo de contatos e selecionar pessoas salvas na Agenda de Endereços ao endereçar um e-mail.

Como criar um campo de hiperlink no Access 2010

Como criar um campo de hiperlink no Access 2010

Crie um campo de Hiperlink no Access 2010 no Modo de Exibição de Design e, em seguida, adicione e teste links para sites, e-mails ou arquivos compartilhados com os detalhes de destino corretos.

Como remover metadados e conteúdo ocultos de um documento do Word

Como remover metadados e conteúdo ocultos de um documento do Word

Use o Inspetor de Documentos do Word para revisar detalhes do autor, comentários, alterações controladas, texto oculto e outros dados antes de compartilhar, e descubra o que a verificação pode não detectar.

Exportar e importar configurações da Faixa de Opções e da Barra de Ferramentas de Acesso Rápido no Office 2010

Exportar e importar configurações da Faixa de Opções e da Barra de Ferramentas de Acesso Rápido no Office 2010

Mova guias personalizadas da Faixa de Opções e comandos da Barra de Ferramentas de Acesso Rápido no Office 2010 com um arquivo .exportedUI e proteja as configurações já existentes no seu computador de destino.

Converter uma planilha do Excel em papel quadriculado imprimível

Converter uma planilha do Excel em papel quadriculado imprimível

Crie papel quadriculado imprimível no Excel ajustando as dimensões das células, definindo uma área de impressão, escolhendo papel A4 e ativando a impressão de linhas de grade no Excel para desktop.