Primeiramente vamos instalar na distro Ubuntu.

1. Caso já o possua instalado e em perfeito estado, pule para os passos seguintes. Caso não possua instalado, efetue a instalação do Ubuntu de preferência versões 7.xx à 8.xx, com ambiente gráfico (desktop).

2. Tenha ou instale o SGBD PostgreSQL, a instalação é bem simples via apt-get, eu prefiro instalar da seguinte forma, que virou para mim uma receita de bolo:

sudo apt-get install postgresql-8.3 postgresql-client-8.3 pgadmin3 php5-pgsql
$ sudo apt-get install phppgadmin

$ sudo ln -s /etc/phppgadmin/apache.conf /etc/apache2/conf.d/phppgadmin.conf

$ sudo vim /usr/share/phppgadmin/conf/config.inc.php

Procure pela linha:

$conf['extra_login_security'] = true;

E altere para:


Salve o arquivo (:wq) e reinicie o Apache:

sudo /etc/init.d/apache2 reload

Edite o arquivo /etc/apache2/conf.d/phppgadmin e descomente a linha:


Okay, muitos vão falar que isso prejudica a segurança, mas volto a afirmar, isso é para testes, em produção volte a configuração anterior e implemente a segurança desejada.

3. Configurando banco de dados

Antes, certifique-se de que a versão do PostgreSQL instalada é a 8.1 ou superior.

É importante observar que para o funcionamento correto do Stoq é necessário que o enconding do banco de dados seja sempre UNICODE.

Note que no lugar de Stoq poderia ser usado o nome do usuário logado em seu sistema. Crie um usuário chamado "stoq" para as aplicações Stoq:

sudo -u postgres createuser stoq -drs -P

Digite a senha do seu usuário:

Password: ******

Depois escolha uma senha nova para o usuário stoq:

Enter password for new role: ******
Enter it again: ******

Obs.: caso a configuração de acesso do seu PostgreSQL seja do tipo confiável, o argumento -P não será necessário e a senha então não será solicitada. O arquivo de configuração do PostgreSQL em geral se encontra em /etc/postgresql/pg_hba.conf.

Atualização da base de dados:

Para novas versões, pode ser necessária a atualização da base de dados, para isto, somente execute o comando abaixo:

stoqdbadmin updateschema

4. Os demais passos foram seguidos de acordo com as instruções do desenvolvedor do software e nenhum passo foi feito a mais ou a menos, portanto sua informação será mantida de forma integral.

5. Adicionando o repositório:

O primeiro passo para instalar o Stoq é adicionar o repositório oficial à lista de repositórios do Ubuntu.


Você pode fazer isso de diversas formas diferentes, entre elas:

a. Utilizando o Synaptic:

• Acesse o Synaptic pelo menu Sistema > Administração > Gerenciador de pacotes Synaptic;
• Se solicitado, coloque sua senha;
• Note que o usuário que estiver realizando esses passos deve pertencer ao grupo de administradores;
• Clique no menu configurações e depois em repositórios;
• Na aba Programas de terceiros, clique em Adicionar;
• Copie e cole a linha indicada acima.

b. Utilizando um terminal:

• Logue no sistema como usuário root;
• Adicione a linha indicada acima ao arquivo /etc/apt/sources.list;
• Digite no terminal: sudo apt-get update

Instalando o Stoq

Se você utilizou o Synaptic para adicionar o repositório, já pode procurar pelo Stoq e instalá-lo.

Já se você adicionou o repositório usando um terminal, pode instalar o stoq dessa forma:

sudo apt-get --allow-unauthenticated install stoq

Instalando o servidor o PostgreSQL:

sudo apt-get install postgresql

Observando aqui que o Stoq suporta versões do PostgreSQL iguais ou superiores à versão 8.1.

Veja também as instruções para configurar o postgres.

Autenticando os pacotes:

Se você deseja que os pacotes do Stoq sejam autenticados, precisa executar os comandos abaixo após a instalação:

sudo gpg --keyserver wwwkeys.us.pgp.net --recv-keys 776EF24D
ou
sudo gpg --keyserver subkeys.pgp.net --recv-keys 776EF24D

E por fim:

gpg -a --export 776EF24D | sudo apt-key add -