Há duas formas principais de usar a Urbit: como planeta ou como cometa. Dissemos no artigo sobre o que é Urbit que há um número limitado de planetas, o que os torna valiosos (custam geralmente em torno de US$10 no mercado).
Os cometas, por outro lado, são gratuitos.
Além do custo de aquisição de um planeta, é comum que os usuários contratem serviços de hospedagem para rodar seu planeta 24 horas por dia, o que traz outro custo extra de cerca de US$ 9 por mês. O motivo disso é o fato de que cada usuário na Urbit trabalha como um servidor, como já explicamos anteriormente.
Felizmente, você não precisa incorrer em nenhum destes custos se quiser apenas explorar Urbit pela primeira vez. É possível fazer tudo de graça através de um cometa, como lhe ensinaremos neste guia passo a passo.
1) Faça o download do software Urbit
Se você é um usuário Windows, recomendamos que primeiro instale o Subsistema Windows para Linux (WSL) e depois volte aqui para seguir os comandos do Linux, como ensinamos no final deste artigo.
Para MAC ou Linux, você precisa abrir o terminal/shell e digitar o seguinte comando:
Para computadores MAC:
curl -L https://urbit.org/install/mac/latest | tar xzk --strip=1 && ./urbitPara computadores Linux:
curl -L https://urbit.org/install/linux64/latest | tar xzk --strip=1 && ./urbitSe tudo correu bem, você deve ver a seguinte mensagem após a instalação:
Urbit: a personal server operating function
Neste caso, você pode prosseguir para a etapa 2).
*Se você encontrar um erro como “curl: comando não encontrado”, significa que primeiro você precisa instalar o “curl” antes de executar o código acima. Digite em seu terminal:
sudo apt-get install curlDigite sua senha para conceder permissão, e se em algum momento o terminal fizer uma pergunta como “Do you want to continue? [Y/N]“, digite Y e pressione ENTER.
Depois de instalar o curl, tente entrar novamente no comando de instalação Urbit que anteriormente tinha falhado.
2) Criar uma identidade Urbit de Cometa
Como você já instalou o Urbit, o terminal/shell/prompt de seu computador está pronto para reconhecer comandos específicos do Urbit. O primeiro comando que você usará é o comando para criar uma identidade. Digite seu terminal/shell/prompt:
./urbit -c meuprimeirocometaVocê pode substituir “meuprimeirocometa” por qualquer nome que desejar. Uma pasta será criada em seu computador com este nome, e todos os arquivos Urbit criados usando este cometa serão armazenados lá.
Normalmente leva alguns minutos para inicializar o cometa, mas também pode levar mais tempo.
Uma vez terminado, seu terminal exibirá uma mensagem indicando que agora você está usando a shell Urbit, chamada dojo. A mensagem em seu prompt terá algo semelhante a isto:
ames: live on 32457
http: web interface live on http://localhost:8080
http: loopback live on http://localhost:12321
~togtun_pocres:dojo>Não se preocupe, esta mensagem está apenas fornecendo informações sobre a rede e o acesso.
Note que o campo ~togtun_pocres:dojo> significa que agora você pode enviar comandos diretamente ao sistema Urbit, através de seu terminal chamado dojo. O nome após o símbolo ~ será diferente daquele mostrado acima, pois representa sua identidade Urbit.
Certo, agora que você criou seu cometa, você pode acessar a interface visual Urbit no passo 3.
*Se você encontrar algum erro ao tentar executar o comando ./urbit no Linux, é provavelmente porque você não tem as permissões necessárias. Isto é fácil de resolver:
Se você acabou de instalar o Urbit, você já está no diretório correto, então você pode simplesmente usar o comando:
chmod +x urbitE então tente novamente o comando:
./urbit -c meuprimeirocometaSe você não estiver no diretório correto, use o seguinte comando para procurá-lo:
find ~ -type f -name “urbit”Então navegue até o diretório, que será o endereço completo antes de /urbit, por exemplo, se o resultado do comando acima foi /home/myuser/urbit, use o seguinte comando para navegar até o diretório correto:
cd /home/myuserDepois de estar no diretório correto e executar o comando de permissão, agora você pode digitar:
./urbit -c meuprimeirocometa3) Abra a Urbit em seu navegador
A interface visual do Urbit pode ser acessada por qualquer navegador (como o Google Chrome, por exemplo). Tudo que você precisa fazer é usar a barra de endereços (o mesmo lugar onde você digita um endereço de website, como google.com) e digitar http://localhost:8080
Quando você digitar isto e pressionar enter, a interface visual Urbit aparecerá, como a da imagem abaixo:
Entendendo o que aconteceu até aqui: quando você criou uma identidade Urbit, o software configurou automaticamente uma porta para a comunicação do seu computador com a rede Urbit. Esta porta por padrão é a porta 8080 para Linux, então você digitou localhost:8080. Eventualmente Urbit pode ter se conectado a outra porta, como a 80, ou qualquer outra porta, se ela já estivesse sendo utilizada. Para descobrir qual porta foi utilizada, veja as informações que apareceram no terminal depois que você criou um cometa.
Ok, neste ponto, você só precisa de uma senha para entrar em Urbit. Vamos obter essa senha.
4) Faça o login com as credenciais fornecidas
O último passo antes que você possa navegar na rede Urbit como cometa é fazer o login. As credenciais podem ser obtidas no terminal/shell/prompt que você estava usando para instalar e criar o cometa, porque o dojo agora está disponível, então quando você retornar ao terminal em que estava trabalhando antes, você enviará este comando diretamente para o dojo:
+codeBasta digitar o comando acima e pressionar enter em seu terminal.
As credenciais de login (Access Key) aparecerão.
Copie esta chave de acesso e use-a na interface visual Urbit que já está aberta em seu navegador. Em seguida, clique em “Continue”.
Parabéns! Agora você está dentro do Urbit!
Você verá um painel de controle semelhante a este:
Para aprender como usar Urbit pela primeira vez, explorando algumas aplicações e o ecossistema, leia este artigo.
5) Encerre o cometa
Após navegar pela Urbit, você pode encerrar seu cometa digitando |exit in the dojo ou pressionando Ctrl+D.
Se você fechou o terminal Urbit ou desligou seu computador, você pode acessar Urbit novamente como um cometa de duas maneiras: criando um novo cometa (neste caso, basta abrir o terminal/shell de seu computador e seguir os passos 2) em diante) ou reiniciando seu cometa criado anteriormente.
Para este último caso, use o código:
./urbit -c meuprimeirocometaSubstitua “meuprimeirocometa” pelo nome que você deu ao seu cometa e siga os passos 3) em diante.
Para usuários do Windows:
Como a Urbit ainda está em construção, é comum a ocorrência de alguns bugs, especialmente para usuários do Windows. É por isso que recomendamos o uso do Linux, pois ele é mais estável. A boa notícia é que o Windows 10 ou mais recente oferece suporte nativo para rodar Linux, através do Subsistema Windows para Linux (WSL).
Esta WSL permite rodar aplicações e comandos Linux, bem como instalar distribuições Linux completas no Windows.
Para instalar o Subsistema Windows para Linux (WSL) no Windows, siga estes passos:
- Abra o “Painel de Controle” e selecione “Programas e Recursos”.
- Clique em “Ativar ou desativar recursos do Windows”.
- Role para baixo para encontrar a opção “Subsistema do Windows para Linux”.
- Marque a caixa de seleção ao lado desta opção e clique em “OK”:
Importante: Verifique também se a opção “Plataforma de Máquina Virtual” está selecionada!
- Reinicie o computador quando solicitado.
- Após o computador reiniciar, abra o “Microsoft Store” e procure por “wsl”. Instale.
Agora você pode pesquisar e instalar uma distribuição Linux de sua escolha (por exemplo, Ubuntu). O Linux tem distribuições diferentes, que são “versões” ligeiramente diferentes do sistema operacional. Qualquer uma delas deve funcionar, mas optar por distribuições populares como o Ubuntu é sempre uma boa escolha.
- Uma vez concluída a instalação do Ubuntu, abra o menu Iniciar e procure por Ubuntu. Clique no resultado da busca para iniciar o sistema operacional.
- Na primeira vez que você iniciar o Ubuntu, você precisará configurar um nome de usuário e uma senha.
Se você nunca usou Linux antes, você pode achar estranho que o cursor não se mova quando você digita a senha. Isto é normal, a senha está sendo processada, mesmo que não pareça. Portanto, basta digitar sua senha e pressionar ENTER.
É isso aí! Agora você tem a WSL instalada e pode executar comandos e aplicações Linux diretamente no Windows.
Agora, sempre que você quiser usar o Urbit, primeiro abra o Ubuntu que já está instalado e depois siga os passos que mostramos neste tutorial como se você estivesse em um ambiente Linux. Em outras palavras, execute os passos 1) a 5) usando os comandos Linux, pois você estará usando o sistema Ubuntu para instalar e usar o Urbit.
Próximos passos
Agora que você está dentro da Urbit, você pode usar as aplicações da plataforma, como explicamos neste artigo.
Veja também: Curso de Urbit para iniciantes
Retornar para: Início