Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

Passwordcockpit - develop environment


This README will explain the steps needed to setup and start the Passwordcockpit for development purposes.


Docker and docker-compose are needed for the setup.


First of all: copy the docker-compose-develop.yml file in your project folder, and rename it to docker-compose.yml.
The IP of the host machine is needed. Replace [YOUR-IP] in the docker-compose.yml file with your ip. There should be 3 replacements.

Then simply run docker-compose up.

Images needed by the docker-compose file are provided from its Docker Hub organization.

This will install the Passwordcockpit webapp, and create in the current folder backend, frontend and database folders. The backend and frontend folders are GIT projects.
The database will already contain some tests data.

The environment variables can be modified, but please note that if you want to modify PASSWORDCOCKPIT_BLOCK_CIPHER_KEY, all passwords should be deleted from the database since they are encrypted with this key.

First steps

the docker-compose up command may take a while. The web application will be ready when the following message appears:

passwordcockpit_frontend    | Build successful ( – Serving on http://localhost:4200/

The current branch on both frontend and backend is develop, but is an old develop branch. Please check the GIT and see the current branch. You should checkout to this branch and call docker-compose restart passwordcockpit_frontend.

After that, go to [YOUR-IP]:4200. If everything went correctly, there should be a login page.

The default admin login credentials are:

  • username: admin
  • password: Admin123!

Default user:

  • username: user
  • password: User123!

If the first login results in a Undefined error, the certificate needs to be accepted. In most browsers, go to [YOUR-IP]:4344 and accept it.