Skip to content

Commit 0194679

Browse files
committed
Added changes for version 0.5.0
1 parent 6ba20d0 commit 0194679

File tree

2 files changed

+44
-2
lines changed

2 files changed

+44
-2
lines changed

docs/self-hosting/configuration.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,6 +86,18 @@ DB_USERNAME="***"
8686
DB_PASSWORD="***"
8787
```
8888

89+
## PDF rendering
90+
91+
If you want to use solidtime features that create PDFs, like exporting a report as PDF, you need to configure a PDF rendering server.
92+
solidtime uses [Gotenberg](https://gotenberg.dev/) to render PDFs.
93+
The application needs to be able to send requests to the Gotenberg server.
94+
The self-hosting guide already includes a Gotenberg container.
95+
The environment variable `GOTENBERG_URL` is used to configure the URL of the Gotenberg server.
96+
97+
```bash
98+
GOTENBERG_URL=http://gotenberg:3000
99+
```
100+
89101
## Email
90102

91103
Configure the email settings for sending emails. Solidtime supports every (transactional) mail service that offers an SMTP integration.

docs/self-hosting/guides/docker.md

Lines changed: 32 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -113,11 +113,41 @@ To do this you can set the environment variable `AUTO_DB_MIGRATE` to `true` in t
113113
114114
You can now access the application in your browser. The URL depends on your setup.
115115
116-
### 7. Testing the setup (optional)
116+
### 7. Create a user
117+
118+
Depending on your configuration of the `APP_ENABLE_REGISTRATION` environment variable, you can either create a user via the registration form or you need to create a user via the CLI.
119+
Per default the registration is disabled.
120+
121+
You can create a user via the CLI with the following command:
122+
123+
```bash
124+
docker compose exec scheduler php artisan admin:user:create "Firstname Lastname" "[email protected]" --verify-email
125+
```
126+
127+
More information about the CLI commands can be found in the [CLI commands documentation](../cli-commands).
128+
129+
If you want this first user to be a super admin, you can add the email address to the `SUPER_ADMINS` environment variable in the `laravel.env` file.
130+
131+
```env
132+
SUPER_ADMINS="[email protected]"
133+
```
134+
135+
The command output a random password for the user.
136+
Afterwards you need to restart the containers:
137+
138+
```bash
139+
docker compose down && docker compose up -d
140+
```
141+
142+
Then you should be able log in with the user you created.
143+
If the user is a super admin, you can access the super admin panel via `/admin`.
144+
More information about the super admin panel can be found in the [super admin panel documentation](../super-admin-panel).
145+
146+
### 8. Testing the setup (optional)
117147

118148
You can find information about how to test the setup in the [testing documentation](../testing).
119149

120-
### 8. Activate Desktop client access (optional)
150+
### 9. Activate Desktop client access (optional)
121151

122152
The solidtime Desktop client authenticates with the API with OAuth.
123153
The Desktop client needs a client. You can create a client by running the following command:

0 commit comments

Comments
 (0)