Skip to main content

Documentation Index

Fetch the complete documentation index at: https://test.pzona.fun/llms.txt

Use this file to discover all available pages before exploring further.

When you create a database, mkdb generates a connection string in environment variable format and prints it immediately after creation. The string is ready to paste directly into a .env file or use in a shell script. You can also retrieve it at any time using the mkdb creds commands.

Connection string formats

With authentication:
DB_URL=postgresql://dbuser:<password>@localhost:5432/mydb
Without authentication (--no-auth):
DB_URL=postgresql://postgres@localhost:5432/mydb

Retrieving your connection string

Print the connection string for a container to your terminal:
mkdb creds get --name mydb
Copy it directly to your clipboard:
mkdb creds copy --name mydb
Append it to a .env file:
mkdb creds get --name mydb >> .env

Password details

When you create a database with authentication enabled, mkdb generates a random 12-character alphanumeric password. The password is displayed once at creation time and stored encrypted on disk using AES-256-GCM. You can always retrieve it later with mkdb creds get.

Rotating credentials

Generate a new password for an existing container and update it in the database:
mkdb creds rotate --name mydb
mkdb generates a fresh 12-character password, updates the running database, re-encrypts and stores the new value, then prints the updated connection string.
Containers created with --no-auth do not have a password. Running mkdb creds rotate on an unauthenticated container will return an error. You cannot add authentication to a container after creation.