Docker Installation¶

The installation with Docker_allows to keep the application isolated from the system and you could try other versions without installing any additional package.

sysPass could be ran in Docker containers which have been built using Debian 8 and verified to work fine, without performing packages compilation.

The Docker images could be downloaded from Docker Hub`_ which have been built automatically from Docker files at https://github.com/nuxsmin/docker-syspass

There are two choices for the installation:

With Docker Compose, which allows to perform a full deployment of sysPass and the database.
With Docker, it would be needed to deploy sysPass and the database separately

Docker Compose¶

Create the “docker-compose.yml” file and run docker-compose:

version: '2'
services:
  app:
    container_name: syspass-app
    image: nuxsmin/docker-syspass:latest
    restart: always
    ports:
      - "80:80"
      - "443:443"
    links:
      - db
    volumes:
      - /var/www/html/sysPass/config
      - /var/www/html/sysPass/backup
  db:
    container_name: syspass-db
    restart: always
    image: nuxsmin/docker-syspass:mysql
    ports:
      - "3306"
    environment:
      - DB_REMOTE_HOST=syspass-app.syspass_default
      - DB_REMOTE_ROOT_PASS=syspass
    volumes:
      - /var/lib/mysql

docker-compose -p syspass -f docker-compose.yml up -d

This will download the sysPass stable image and the MySQL database.

Note

When using Docker Compose, a separated network is created automatically for the sysPass containers and it’s possible to use the DNS resolution.

The sysPass container has 2 volumes: one for the “config” directory and another for “backup”

Warning

The sysPass container will publish the host’s ports 80 and 443

Docker¶

To get the individual images you would need to run the following commands:

docker run -d --name syspass-db -h syspass-db nuxsmin/docker-syspass:mysql
docker run -d --name syspass-app -h syspass-app --link syspass-db nuxsmin/docker-syspass:latest

Access¶

The database access parameters are:

Host: syspass-db
User: root
Password: syspass

It’s possible to install other sysPass images on Docker Hub

Note

Please, follow installer steps and after the successful finishing, you will be able to log into the application

To know how sysPass works, please see Application

Warning

It’s advisable to read the security recommendations on Security