Docker
Install Docker CE (https://docs.docker.com/engine/installation/).
Install Docker Compose (https://docs.docker.com/compose/install/).
Create a new directory /server and clone configuration files from public git repository:
Remove file from the destination folder:
Clone the repository using your login and password:
💡 The system will ask for a login and password to the repository, which you can find in your Customer Portal. If you don't have access to the Customer Portal, contact us.
When you open Passwork for the first time, you will see an installation wizard that will check if the server is configured correctly and allow you to enter the basic parameters.
💡 If you are installing a new copy of Passwork, leave all fields in their default values, except for the database connection string. In it, you need to change localhost to db.
Sign up an administrator
Enter the username and password for the first user. The user will automatically become the administrator and owner of the organization.
Nginx container uses Postfix for sending mail. All configuration files you can find here:
Edit them to suit your needs. Restart Postfix for the changes to take effect.
Open the configuration file /server/conf/postfix/main.cf.
Make sure the myhostname parameter matches the fully qualified domain name of your server:
Open or create the file /server/conf/postfix/sasl_passwd.
Add SMTP host, username and password should be written in the following format:
If you want to use a non-standard TCP port (for example 587) use the following format:
For Gmail, the entry will look like this:
Create a hashed database for Postfix, run the postmap command:
After successful execution of the command, a new file sasl_passwd.db should appear in the /server/conf/postfix directory.
The files /server/conf/postfix/sasl_passwd and /server/conf/postfix/sasl_passwd.db created in the previous steps contain your SMTP credentials in plain text. For security reasons, you should change the permissions on them so that only the root user can read and write to the file.
Run the following commands to change the owner of the files to root and update the file permissions:
Open the file /server/conf/postfix/main.cf.
Change the relayhost parameter to your external SMTP relay. If a non-standard TCP port was specified in the sasl_passwd file, then you must use the same port when configuring the relayhost parameter.
Specify SMTP relay:
For Gmail, the entry will look like this:
At the end of the file, add the following parameters to enable authentication:
Save the changes.
Restart Postfix:
Copy dexec utility:
Bash to container:
Restore correct permissions:
Reload Nginx without stopping:
Docker containers run with autostart feature. It means that Docker automatically launches containers again if a root process is down (the roots process are nginx and mongodb).
If you need to stop container you need to disable the autostart feature before:
Don't forget to enable the autostart:
When the containers are not autostartable you can forcse stop the services:
If the containers are autostartable these commands just restart the services.
Use it in emergency case because it can corrupt containers data.
Configuration files:
Data (mongo database):
Logs:
Web-site:
Edit configuration files:
Restart nginx and php-fpm:
