Manual Setup

If you prefer to manually set up AliasVault, this README provides step-by-step instructions. Follow these steps if you prefer to execute all statements yourself.

Prerequisites

Docker and Docker Compose installed on your system
OpenSSL for generating random passwords

Steps

Create required directories

Create the following directories in your project root:
```
mkdir -p certificates/ssl certificates/app database logs/msbuild
```
Create .env file

Copy the .env.example file to create a new .env file:
```
cp .env.example .env
```
Set HOSTNAME

Update the .env file with your hostname (default is localhost):
```
HOSTNAME=localhost
```
Generate and set JWT_KEY

Generate a random 32-char string for JWT token generation:
```
openssl rand -base64 32
```
Add the generated key to the .env file:
```
JWT_KEY=your_generated_key_here
```
Generate and set DATA_PROTECTION_CERT_PASS

Generate a random password for the data protection certificate:
```
openssl rand -base64 32
```
Add it to the .env file:
```
DATA_PROTECTION_CERT_PASS=your_generated_password_here
```
Set PRIVATE_EMAIL_DOMAINS

Update the .env file with allowed email domains. Use DISABLED.TLD to disable email support:
```
PRIVATE_EMAIL_DOMAINS=yourdomain.com,anotherdomain.com
```
Or to disable email:
```
PRIVATE_EMAIL_DOMAINS=DISABLED.TLD
```
Set SUPPORT_EMAIL (Optional)

Add a support email address if desired:
```
SUPPORT_EMAIL=support@yourdomain.com
```

Generate admin password

Build the Docker image for password hashing:

docker build -t installcli -f src/Utilities/AliasVault.InstallCli/Dockerfile .

Generate the password hash:

docker run --rm installcli "your_preferred_admin_password_here"

Add the password hash and generation timestamp to the .env file:

ADMIN_PASSWORD_HASH=<output_from_previous_command>
ADMIN_PASSWORD_GENERATED=2024-01-01T00:00:00Z

Build and start Docker containers

Build the Docker Compose stack:
```
 docker compose build
```
Start the Docker Compose stack:
```
 docker compose up -d
```
Access AliasVault

AliasVault should now be running. You can access it at:
- Admin Panel: https://localhost/admin
  - Username: admin
  - Password: [Use the password you set in step 8]
- Client Website: https://localhost/
  - Create your own account from here

Important Notes

Make sure to save the admin password you used in step 8 in a secure location.
If you need to reset the admin password in the future, repeat step 8 and restart the Docker containers.
Always keep your .env file secure and do not share it, as it contains sensitive information.

Troubleshooting

If you encounter any issues during the setup:

Check the Docker logs:
```
docker compose logs
```
Ensure all required ports (80 and 443) are available and not being used by other services.
Verify that all environment variables in the .env file are set correctly.

For further assistance, please refer to the project documentation or seek support through the appropriate channels.