diff --git a/README.md b/README.md
index 26fbe5d..cdc85d3 100644
--- a/README.md
+++ b/README.md
@@ -1 +1 @@
-
# Wave
## The Open Source Blogging Engine
⚠ Under Construction ⚠
alpha-3 image available for the brave
## Quickstart
This docker compose file will give you everything you need to run Wave. See the following
sections for explanations about the configuration and makeup of Wave. Replace <*_password>
with generated passwords, just in case.
For extensive configuration you want to mount `/configuration` to a location on your system.
Afterwards you can access Wave on `http://localhost`.
To see how to create an admin account, read the following section. Afterwards for security
you should [Configure an Email Server](#configuring-email).
```
version: '3.4'
name: wave
services:
web:
image: miawinter/wave
restart: unless-stopped
ports:
- "80:8080"
links:
- database:db
environment:
- "WAVE_ConnectionStrings__DefaultConnection=Host=db; Username=wave; Password="
- "WAVE_ConnectionStrings__Redis=redis,password="
volumes:
- wave-files:/app/files
- wave-config:/configuration
networks:
- wave
depends_on:
- database
database:
image: postgres:16.1-alpine
restart: unless-stopped
environment:
- "POSTGRES_DB=wave"
- "POSTGRES_USER=wave"
- "POSTGRES_PASSWORD="
volumes:
- wave-db:/var/lib/postgresql/data
networks:
- wave
redis:
image: redis:7-alpine
restart: unless-stopped
command: redis-server --requirepass --save 60 1 --loglevel warning
volumes:
- wave-redis:/data
networks:
- wave
volumes:
wave-files:
wave-config:
wave-db:
wave-redis:
networks:
wave:
```
### Admin Access
When Wave does not detect any admin account in it's database on startup , which usually happens during
setup, a message will be printed to it's server console, in docker accessible with `docker logs wave-web-1`:
`There is currently no user in your installation with the admin role, go to /Admin and use the following password to self promote your account: [password]`
The password is 16 digits long, navigate to `http://localhost/Admin`, if you are not logged in you will be redirected to
the login page. Once you are authenticated and have entered the password on the admin page, the tool will be disabled and
you will be a member of the Admin role, giving you full access to all of Waves' features. Keep in mind that the password
is generated every time on startup as long as there is no admin, so if you restart the container, there will be a different
password in the console.
## Configuring Wave
Wave allows you to configure it in many different formats and in multiple places, and
you can even use multiple of the following methods to supply configuration information.
Please keep in mind that first, asp.net configuration keys are case-insensitive, and second,
that there is a precedence in the different formats, so a value for the same key in two
formats will be overwritten by one.
### Configuration Locations
There are two main locations where Wave (and asp.net) takes it's configuration from:
The Environment, and the `/configuration` volume. Environment variables allow you to quickly
set up a docker container, but the more you need to configure the more unmaintainable an
`.env` file (or an `environment:` section in docker compose) becomes, so if you find yourself
customizing a lot of Waves behavior, consider using one of the many supported configuration
file formats.
### Configuration Keys
I will provide you the different configuration keys with a dot notation, like `Email.Smtp.Host`.
In environment variables, these dots need to be replaced with two underscore characters: `__`
and prefixed with `WAVE_`.
In config files, those dots are hierarchy level, and you need to implement that dialects'
syntax for it. Here some examples for `Email.Smtp.Host`:
**Environment**
```
WAVE_Email__Smtp__Host=smtp.example.com
```
**JSON**
```json
{
"Email": {
"Smtp:": {
"Host": "smtp.example.com"
}
}
}
```
**YAML**
```yml
Email:
Smtp:
Host: smtp.example.com
```
### Supported Configuration Formats
Wave will take configuration from the following files in the `/configuration` volume, files
later in this chain will have precedence over files earlier in that chain:
- config.json
- config.yml
- config.toml
- config.ini
- config.xml
After this, values from the Environment will take the highest precedence.
## Configuring Email
Wave may send user related mails every now and then, to confirm an account, reset a password, etc.
In order to support that, Wave needs to have a way to send Emails, currently SMTP is supported
### SMTP
The following configuration is required for Wave to connect to an smtp server
(formatted in YAML for brevity).
```yml
Email:
Smtp:
Host: smtp.example.com
Port: 25
SenderEmail: noreply@example.com
SenderName: Wave
Username: user
Password: password
Ssl: true
```
`Username` and `Password` are optional if your server does not require it, and `Ssl` is
`true` by default, only set it to false if you really need to, keeping security in mind.
## Redis
Wave will generate a variety of keys for anti-forgery and logged in users during it's
runtime. By default, these will be persisted into an in-memory key store, which will be
lost when restarting the Wave container, causing all users to be logged out. To persist
these keys outside of the containers' lifetime, you can configure a redis connection string
using `ConnectionStrings.Redis`.
## Reverse Proxy
In order to make your Wave installation available to the web, you want to use a reverse
proxy to handle things like SSL Certificates. Here are some examples.
### Caddy
In the Caddyfile add:
```
{
reverse_proxy localhost:8080
}
```
If Caddy runs as a docker container, you need to use the Wave container name:
```
{
reverse_proxy wave-web-1:8080
}
```
### Nginx
TODO
## Customizations
TODO implement more customizations, add description
Currently supported:
```yml
Customization:
AppName: My cool blog
```
## Additional Notes
TODO ?
## License and Attribution
Wave by [Mia Winter](https://miawinter.de/) is licensed under the [MIT License](https://en.wikipedia.org/wiki/MIT_License).
Copyright (c) 2024 Mia Rose Winter
\ No newline at end of file
+
# Wave
## The Open Source Blogging Engine
⚠ Under Construction ⚠
alpha-3 image available for the brave
## Quickstart
This docker compose file will give you everything you need to run Wave. See the following
sections for explanations about the configuration and makeup of Wave. Replace <*_password>
with generated passwords, just in case, replace your-time-zone with a sensible time zone
for your users.
For extensive configuration you want to mount `/configuration` to a location on your system.
Afterwards you can access Wave on `http://localhost`.
To see how to create an admin account, read the following section. Afterwards for security
you should [Configure an Email Server](#configuring-email).
```
version: '3.4'
name: wave
services:
web:
image: miawinter/wave
restart: unless-stopped
ports:
- "80:8080"
links:
- database:db
environment:
- "TZ="
- "WAVE_ConnectionStrings__DefaultConnection=Host=db; Username=wave; Password="
- "WAVE_ConnectionStrings__Redis=redis,password="
volumes:
- wave-files:/app/files
- wave-config:/configuration
networks:
- wave
depends_on:
- database
database:
image: postgres:16.1-alpine
restart: unless-stopped
environment:
- "POSTGRES_DB=wave"
- "POSTGRES_USER=wave"
- "POSTGRES_PASSWORD="
volumes:
- wave-db:/var/lib/postgresql/data
networks:
- wave
redis:
image: redis:7-alpine
restart: unless-stopped
command: redis-server --requirepass --save 60 1 --loglevel warning
volumes:
- wave-redis:/data
networks:
- wave
volumes:
wave-files:
wave-config:
wave-db:
wave-redis:
networks:
wave:
```
### Admin Access
When Wave does not detect any admin account in it's database on startup , which usually happens during
setup, a message will be printed to it's server console, in docker accessible with `docker logs wave-web-1`:
`There is currently no user in your installation with the admin role, go to /Admin and use the following password to self promote your account: [password]`
The password is 16 digits long, navigate to `http://localhost/Admin`, if you are not logged in you will be redirected to
the login page. Once you are authenticated and have entered the password on the admin page, the tool will be disabled and
you will be a member of the Admin role, giving you full access to all of Waves' features. Keep in mind that the password
is generated every time on startup as long as there is no admin, so if you restart the container, there will be a different
password in the console.
## Configuring Wave
Wave allows you to configure it in many different formats and in multiple places, and
you can even use multiple of the following methods to supply configuration information.
Please keep in mind that first, asp.net configuration keys are case-insensitive, and second,
that there is a precedence in the different formats, so a value for the same key in two
formats will be overwritten by one.
### Configuration Locations
There are two main locations where Wave (and asp.net) takes it's configuration from:
The Environment, and the `/configuration` volume. Environment variables allow you to quickly
set up a docker container, but the more you need to configure the more unmaintainable an
`.env` file (or an `environment:` section in docker compose) becomes, so if you find yourself
customizing a lot of Waves behavior, consider using one of the many supported configuration
file formats.
### Configuration Keys
I will provide you the different configuration keys with a dot notation, like `Email.Smtp.Host`.
In environment variables, these dots need to be replaced with two underscore characters: `__`
and prefixed with `WAVE_`.
In config files, those dots are hierarchy level, and you need to implement that dialects'
syntax for it. Here some examples for `Email.Smtp.Host`:
**Environment**
```
WAVE_Email__Smtp__Host=smtp.example.com
```
**JSON**
```json
{
"Email": {
"Smtp:": {
"Host": "smtp.example.com"
}
}
}
```
**YAML**
```yml
Email:
Smtp:
Host: smtp.example.com
```
### Supported Configuration Formats
Wave will take configuration from the following files in the `/configuration` volume, files
later in this chain will have precedence over files earlier in that chain:
- config.json
- config.yml
- config.toml
- config.ini
- config.xml
After this, values from the Environment will take the highest precedence.
## Configuring Email
Wave may send user related mails every now and then, to confirm an account, reset a password, etc.
In order to support that, Wave needs to have a way to send Emails, currently SMTP is supported
### SMTP
The following configuration is required for Wave to connect to an smtp server
(formatted in YAML for brevity).
```yml
Email:
Smtp:
Host: smtp.example.com
Port: 25
SenderEmail: noreply@example.com
SenderName: Wave
Username: user
Password: password
Ssl: true
```
`Username` and `Password` are optional if your server does not require it, and `Ssl` is
`true` by default, only set it to false if you really need to, keeping security in mind.
## Redis
Wave will generate a variety of keys for anti-forgery and logged in users during it's
runtime. By default, these will be persisted into an in-memory key store, which will be
lost when restarting the Wave container, causing all users to be logged out. To persist
these keys outside of the containers' lifetime, you can configure a redis connection string
using `ConnectionStrings.Redis`.
## Reverse Proxy
In order to make your Wave installation available to the web, you want to use a reverse
proxy to handle things like SSL Certificates. Here are some examples.
### Caddy
In the Caddyfile add:
```
{
reverse_proxy localhost:8080
}
```
If Caddy runs as a docker container, you need to use the Wave container name:
```
{
reverse_proxy wave-web-1:8080
}
```
### Nginx
TODO
## Customizations
TODO implement more customizations, add description
Currently supported:
```yml
Customization:
AppName: My cool blog
```
## Additional Notes
TODO ?
## License and Attribution
Wave by [Mia Winter](https://miawinter.de/) is licensed under the [MIT License](https://en.wikipedia.org/wiki/MIT_License).
Copyright (c) 2024 Mia Rose Winter
\ No newline at end of file
diff --git a/Wave/Data/ApplicationDbContext.cs b/Wave/Data/ApplicationDbContext.cs
index 958de41..369b830 100644
--- a/Wave/Data/ApplicationDbContext.cs
+++ b/Wave/Data/ApplicationDbContext.cs
@@ -1,5 +1,6 @@
using Microsoft.AspNetCore.Identity.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
namespace Wave.Data;
@@ -9,6 +10,11 @@ public class ApplicationDbContext(DbContextOptions options
protected override void OnModelCreating(ModelBuilder builder) {
base.OnModelCreating(builder);
+ var dateTimeOffsetUtcConverter = new ValueConverter(
+ model => model.ToUniversalTime(),
+ utc => utc.ToLocalTime()
+ );
+
builder.Entity(user => {
user.Property(u => u.FullName).HasMaxLength(64);
user.Property(u => u.AboutTheAuthor).HasMaxLength(512);
@@ -36,9 +42,13 @@ public class ApplicationDbContext(DbContextOptions options
.IsRequired(false).OnDelete(DeleteBehavior.SetNull);
article.Property(a => a.CreationDate)
- .IsRequired().HasDefaultValueSql("now()");
+ .IsRequired().HasDefaultValueSql("now()")
+ .HasConversion(dateTimeOffsetUtcConverter);
+ article.Property(a => a.PublishDate)
+ .HasConversion(dateTimeOffsetUtcConverter);
article.Property(a => a.LastModified)
- .IsRequired().HasDefaultValueSql("now()");
+ .IsRequired().HasDefaultValueSql("now()")
+ .HasConversion(dateTimeOffsetUtcConverter);
article.HasQueryFilter(a => !a.IsDeleted);
});
diff --git a/docker-compose.yml b/docker-compose.yml
index 6fe9f1f..7a8a8c5 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -13,6 +13,7 @@ services:
links:
- database:db
environment:
+ - "TZ=Europe/Berlin"
- "WAVE_ConnectionStrings__DefaultConnection=Host=db; Username=wave; Password=development"
- "WAVE_ConnectionStrings__Redis=redis,password=development"
volumes: