Always redirect to admin

[jaalvarez2818]

What is the bug or the crash? What were your expectations and what actually happened?

Hi, can you help me?

I'm setting up QField Cloud with Docker Compose, following the basic instructions.

When I access it via https://localhost, it keeps trying to redirect me to the admin page and fails; it seems to get stuck in a redirect loop.

I've already registered users, and they register correctly, but then I can't authenticate because it redirects to /admin.

Thank you very much.

Steps to reproduce the issue

Hi, can you help me?

I'm setting up QField Cloud with Docker Compose, following the basic instructions.

When I access it via https://localhost, it keeps trying to redirect me to the admin page and fails; it seems to get stuck in a redirect loop.

I've already registered users, and they register correctly, but then I can't authenticate because it redirects to /admin.

Thank you very much.

Version

last

Operating system name

Linux

Operating system version

Linux

Reinstall QFieldCloud

• I have a fresh install of the latest QFieldCloud version, but the problem persists.
• I have the latest available Docker engine installed on my machine.
• Problem can be reliably reproduced, doesn't happen randomly.

Additional context

No response

[m-lmi]

same here. I always get redirected to admin site. How do I get the user view side?

[llgis]

any ideas how to solve this problem?

[unoprogramado]

Hi, I was also facing this issue, but I managed to solve it in a different way.

First of all, this panel is not intended to be accessed by regular users. It should only be accessible to authorized people, since it is an admin panel. Because of that, it also doesn’t make sense to have a register option on the login screen if the goal is not to create admin accounts.

Based on this, I investigated further and found a solution.

I’m not sure if this behavior is a bug or if it was designed this way, but I’m sharing it here.

Sorry if my explanation is not perfectly clear — I’m Brazilian and I don’t speak English fluently.

The step-by-step instructions are in Portuguese.

Guia Completo: Configurar QFieldCloud com Usuários Admin Automáticos

📋 Objetivo

Este guia mostra como configurar o QFieldCloud para que todos os usuários registrados sejam automaticamente administradores (admin).

---

🔧 Pré-requisitos

• Docker e Docker Compose instalados
• QFieldCloud clonado e configurado
• Acesso ao terminal/bash

---

📝 Passo a Passo

1️⃣ Modificar o Código Fonte (ANTES do Build)

Opção A: Se você VAI fazer build/rebuild

Edite o arquivo no código fonte do host antes de fazer o build:

# Localize o arquivo (pode estar em um desses caminhos):
# - docker-app/qfieldcloud/core/adapters.py
# - qfieldcloud/core/adapters.py

nano ~/QFieldCloud/docker-app/qfieldcloud/core/adapters.py

Procure o método new_user (por volta da linha 50-60) e modifique de:

def new_user(self, request):
    """
    Instantiates a new User instance.
    """
    user = Person()
    return user

Para:

def new_user(self, request):
    """
    Instantiates a new User instance.
    """
    user = Person()
    # Automaticamente dar permissões de admin para novos usuários
    user.is_staff = True
    user.is_superuser = True
    return user

Salve o arquivo (Ctrl+O, Enter, Ctrl+X).

---

Opção B: Se o container JÁ está rodando (modificação temporária)

Se você não quer fazer rebuild, modifique diretamente no container:

docker compose exec -T -u root app python << 'EOF'
# Ler o arquivo
with open('/usr/src/app/qfieldcloud/core/adapters.py', 'r') as f:
    content = f.read()

# Fazer a substituição
old_code = '''    def new_user(self, request):
        """
        Instantiates a new User instance.
        """
        user = Person()
        return user'''

new_code = '''    def new_user(self, request):
        """
        Instantiates a new User instance.
        """
        user = Person()
        # Automaticamente dar permissões de admin para novos usuários
        user.is_staff = True
        user.is_superuser = True
        return user'''

content = content.replace(old_code, new_code)

# Salvar o arquivo
with open('/usr/src/app/qfieldcloud/core/adapters.py', 'w') as f:
    f.write(content)

print("✓ Arquivo modificado com sucesso!")
EOF

⚠️ ATENÇÃO: Esta modificação será perdida se você fizer rebuild da imagem!

---

2️⃣ Verificar se a Modificação foi Aplicada

docker compose exec app cat /usr/src/app/qfieldcloud/core/adapters.py | grep -A 8 "def new_user"

Resultado esperado:

def new_user(self, request):
    """
    Instantiates a new User instance.
    """
    user = Person()
    # Automaticamente dar permissões de admin para novos usuários
    user.is_staff = True
    user.is_superuser = True
    return user

Se aparecer as linhas user.is_staff = True e user.is_superuser = True, está correto! ✅

---

3️⃣ Build/Rebuild do Container (se necessário)

Se você editou o arquivo no host (Opção A):

cd ~/QFieldCloud
docker compose up -d --build

Se você editou diretamente no container (Opção B), apenas reinicie:

docker compose restart app

---

4️⃣ Executar as Migrations do Django

docker compose exec app python manage.py migrate

Este comando cria todas as tabelas necessárias no banco de dados.

---

5️⃣ Atualizar Usuários Existentes

Se você já tem usuários no banco que não são admin, execute:

docker compose exec -T app python << 'EOF'
from qfieldcloud.core.models import Person

for user in Person.objects.all():
    user.is_staff = True
    user.is_superuser = True
    user.save()
    print(f"✓ {user.username} agora é admin")
EOF

---

6️⃣ Verificar se Funcionou

Verificar um usuário específico:

docker compose exec -T app python << 'EOF'
from qfieldcloud.core.models import Person

user = Person.objects.get(username='SEU_USERNAME_AQUI')
print(f"Username: {user.username}")
print(f"is_staff: {user.is_staff}")
print(f"is_superuser: {user.is_superuser}")
EOF

Listar todos os usuários:

docker compose exec -T app python << 'EOF'
from qfieldcloud.core.models import Person

for user in Person.objects.all():
    print(f"{user.username}: is_staff={user.is_staff}, is_superuser={user.is_superuser}")
EOF

---

7️⃣ Testar o Acesso

1. Acesse: https://localhost/
2. Faça login com um usuário existente ou crie um novo
3. Tente acessar: https://localhost/admin/
4. Você deve conseguir acessar sem problemas! ✅

---

🔍 Verificação de Problemas Comuns

Problema 1: Loop Infinito no Login

Sintoma: Após fazer login, fica redirecionando entre /admin/ e /login/ infinitamente.

Solução: Execute o passo 5️⃣ para atualizar os usuários existentes.

---

Problema 2: relation "django_session" does not exist

Sintoma: Erro ao acessar qualquer página do site.

Solução: Execute as migrations:

docker compose exec app python manage.py migrate

---

Problema 3: Modificação não funcionou para novos usuários

Sintoma: Novos usuários criados não têm permissões de admin.

Causa: Se você usou a Opção B (modificação temporária) e depois fez rebuild, a modificação foi perdida.

Solução: Use a Opção A (modificar no código fonte do host) e faça rebuild.

---

📊 Resumo dos Comandos Principais

# 1. Modificar arquivo (Opção B - temporária)
docker compose exec -T -u root app python << 'EOF'
# [código de modificação aqui]
EOF

# 2. Verificar modificação
docker compose exec app cat /usr/src/app/qfieldcloud/core/adapters.py | grep -A 8 "def new_user"

# 3. Reiniciar/Rebuild
docker compose restart app
# OU
docker compose up -d --build

# 4. Migrations
docker compose exec app python manage.py migrate

# 5. Atualizar usuários existentes
docker compose exec -T app python << 'EOF'
from qfieldcloud.core.models import Person
for user in Person.objects.all():
    user.is_staff = True
    user.is_superuser = True
    user.save()
    print(f"✓ {user.username} agora é admin")
EOF

# 6. Verificar usuário
docker compose exec -T app python << 'EOF'
from qfieldcloud.core.models import Person
user = Person.objects.get(username='SEU_USERNAME')
print(f"is_staff: {user.is_staff}, is_superuser: {user.is_superuser}")
EOF

---

🎯 Explicação Técnica

Por que isso funciona?

1. is_staff: Permite que o usuário acesse o painel administrativo do Django (/admin/)
2. is_superuser: Dá todas as permissões possíveis no sistema

O que foi modificado?

O método new_user no arquivo adapters.py é chamado sempre que um novo usuário é criado através do sistema de registro (signup). Ao adicionar user.is_staff = True e user.is_superuser = True, garantimos que todo novo usuário já seja criado com permissões de administrador.

Modelo de dados

O modelo Person herda de User, que por sua vez herda de AbstractUser do Django. Os campos is_staff e is_superuser são campos padrão do Django definidos em AbstractUser.

AbstractUser (Django)
    ↓
User (QFieldCloud)
    ↓
Person (QFieldCloud)

---

⚠️ Avisos Importantes

1. Segurança: Esta configuração dá permissões de admin para TODOS os usuários. Use apenas em ambientes de desenvolvimento ou ambientes controlados!

2. Persistência: Se você usar a Opção B (modificação temporária), a mudança será perdida ao fazer rebuild. Para ambientes de produção, sempre use a Opção A.

3. Backup: Sempre faça backup do banco de dados antes de fazer modificações significativas.

---

📞 Suporte

Se encontrar problemas:

1. Verifique os logs: docker compose logs app
2. Verifique se o container está rodando: docker compose ps
3. Verifique o banco de dados: docker compose exec db psql -U qfieldcloud -d qfieldcloud

---

Criado em: 02/02/2026
Versão do QFieldCloud: Compatível com versões recentes que usam Django 4.2+
Testado em: Ubuntu/Debian com Docker Compose v2

---

📚 Referências

• Django User Model: https://docs.djangoproject.com/en/4.2/ref/contrib/auth/
• Django Admin: https://docs.djangoproject.com/en/4.2/ref/contrib/admin/
• QFieldCloud: https://github.com/opengisch/qfieldcloud