Setting up authorization in Docker

11min

Backing up and cleaning MongoDB data
Creating a backup
Go to the root directory of the Passwork installation:
Shell
cd /<passwork>/
cd /<passwork>/
﻿
Run the backup script:
Shell
./db-backup.sh
./db-backup.sh
﻿
Clearing collections and data
Stop and delete the passwork_db container:
Shell
docker compose down db
docker compose down db
﻿
Clear previously created MongoDB collections and data:
Shell
rm -rf ./data/mongo/*
rm -rf ./data/mongo/*
﻿
Create a MongoDB user and start the container
Creating a user
Edit and complete the .env variable file. Insert the following lines and specify your values:
Shell
# The name of the database user at initialisation.
MONGO_INITDB_ROOT_USERNAME=adminuser
# The password of the database user at initialisation.
MONGO_INITDB_ROOT_PASSWORD=password
# The name of the database user at initialisation.
MONGO_INITDB_ROOT_USERNAME=adminuser
# The password of the database user at initialisation.
MONGO_INITDB_ROOT_PASSWORD=password
﻿
You can't use characters in MongoDB — .,@,$,:,%,",',/,\,| in the username and password, as this may cause malfunctions in the connection of the application server to MongoDB.
Starting the container
Start the passwork_db container:
Shell
docker compose up -d db
docker compose up -d db
﻿
Check the running container:
Shell
docker ps | grep passwork_db
docker ps | grep passwork_db
﻿
Restoring from backups and connecting Passwork
Restore databases
Run the restore script:
Shell
./db-restore.sh
./db-restore.sh
﻿
Specify the created backup from step one:
Shell
Enter the backup file name to restore: mongo-xxxx-xx-xx-xx:xx:xx.dump
Enter the backup file name to restore: mongo-xxxx-xx-xx-xx:xx:xx.dump
﻿
Verify connection to MongoDB with authorisation:
Shell
docker exec -it passwork_db mongo "mongodb://adminuser:password@localhost:27017"
docker exec -it passwork_db mongo "mongodb://adminuser:password@localhost:27017"
﻿
Setting up and connecting Passwork with authorization
You need to edit the Passwork configuration file — /<passwork>/conf/keys/config.ini section [mongo] specifying the login and password of the created user:
Shell
[mongo]
connectionString = mongodb://localhost:27017
dbname = pwbox
useCreds = true
username = adminuser
password = password
[mongo]
connectionString = mongodb://localhost:27017
dbname = pwbox
useCreds = true
username = adminuser
password = password
﻿
Save the changes and refresh the Passwork web interface page to test the connection with MongoDB authorisation.

Updated 28 Jul 2024

Did this page help you?

Examples of authorization settings

Setting up authorization in Linux