📝 initial readme

This commit is contained in:
DrMaxNix 2024-09-02 22:46:40 +02:00
parent 2a30651693
commit 68c80fd70d

35
README.md Normal file
View File

@ -0,0 +1,35 @@
# Etebase Docker
Run Etebase Server within Docker Container
## Setup Instructions
**Docker Run** (not recommended):
```console
$ docker run -d --name "etebase" -v ./data:/opt/etebase-data -p 8080:80 drmaxnix/etebase
```
**Docker Compose** (recommended):
```yaml
services:
main:
image: drmaxnix/etebase
restart: unless-stopped
volumes:
- ./data:/opt/etebase-data
ports:
- "8080:80"
```
```console
$ docker compose up -d
```
> ▶️ For both variants, persistent config files and user data will be stored in the `./data` directory. Feel free to change this to your needs.
> ▶️ With this setup, the server will publicly listen on port 8080 via unencrypted http. When using in production, make sure to use a reverse proxy to add ssl functionality!
## User Management
Create initial admin account:
```console
$ docker compose exec main .venv/bin/python3 ./manage.py createsuperuser
```
> ▶️ If you are using docker run, replace `docker compose exec main` with `docker exec -it etebase`.