> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhalivre.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> Visão geral do processo de instalação e configuração dos seus pontos de acesso dentro do SenhaLivre.

## Sobre este Guia

Este guia explica passo a passo como configurar Access Points (APs) para funcionar com o SenhaLivre. O processo é dividido em três partes principais:

1. **Configuração do AP** — Acesso inicial e configuração básica do equipamento
2. **Configuração na Controladora** — Criação de redes e hotspot na controladora
3. **Cadastro no SenhaLivre** — Adicionar o ponto de acesso ao sistema

## Controladoras Suportadas

O SenhaLivre suporta múltiplas controladoras de Wi-Fi. Atualmente, você pode usar:

* **Omada Controller** — Para Access Points TP-Link
* **UniFi Controller** — Para Access Points Ubiquiti UniFi

<Info>
  O sistema detecta automaticamente o tipo de controladora baseado na marca do Access Point cadastrado. Isso permite que o portal funcione corretamente com diferentes controladoras sem necessidade de configuração adicional.
</Info>

## Pré-requisitos

Antes de começar, certifique-se de ter:

* Access Point resetado de fábrica (TP-Link ou UniFi)
* Acesso à rede Wi-Fi do AP ou acesso físico ao equipamento
* Credenciais de acesso à controladora (Omada ou UniFi)
* Conta no SenhaLivre com permissões para adicionar pontos de acesso

## Visão geral do Processo

<Steps>
  <Step title="Escolher sua Controladora">
    Selecione qual controladora você vai usar:

    * **Omada Controller** — Para APs TP-Link
    * **UniFi Controller** — Para APs Ubiquiti UniFi
  </Step>

  <Step title="Configurar o AP">
    Acesse o painel de administração do AP e configure as credenciais necessárias para adoção pela controladora. O processo varia conforme a marca do equipamento.
  </Step>

  <Step title="Configurar na Controladora">
    Crie as redes (interna e hotspot) e configure o portal externo na controladora, apontando para o SenhaLivre.
  </Step>

  <Step title="Cadastrar no SenhaLivre">
    Adicione o ponto de acesso no sistema SenhaLivre informando o MAC address e a marca do equipamento.
  </Step>
</Steps>

## Escolha seu Caminho

Siga o guia específico para sua controladora:

### Para Omada Controller (TP-Link)

1. [Configuração do AP TP-Link](/guia-instalacao/configuracao-ap-tplink) — Acesso inicial e configuração básica
2. [Controladora Omada](/guia-instalacao/controladora-omada) — Configuração de redes e hotspot
3. [Cadastro no SenhaLivre](/guia-instalacao/cadastro-senhalivre) — Adicionar ponto ao sistema

### Para UniFi Controller (Ubiquiti)

1. [Configuração do AP UniFi](/guia-instalacao/configuracao-ap-unifi) — Acesso inicial e configuração básica
2. [Controladora UniFi](/guia-instalacao/controladora-unifi) — Configuração de redes e portal externo
3. [Cadastro no SenhaLivre](/guia-instalacao/cadastro-senhalivre) — Adicionar ponto ao sistema

<Tip>
  Mantenha anotadas todas as credenciais criadas durante o processo, pois elas serão necessárias em etapas posteriores. O endereço MAC do AP é especialmente importante para o cadastro no SenhaLivre.
</Tip>