Compare commits
2 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| faf38de099 | |||
| c120ad4b84 |
@@ -13,6 +13,7 @@ and this project adheres to
|
|||||||
- 🛂(frontend) Restore version visibility #629
|
- 🛂(frontend) Restore version visibility #629
|
||||||
- 📝(doc) minor README.md formatting and wording enhancements
|
- 📝(doc) minor README.md formatting and wording enhancements
|
||||||
- ♻️Stop setting a default title on doc creation #634
|
- ♻️Stop setting a default title on doc creation #634
|
||||||
|
- 📝(readme) remove front-end local run instructions local.md #651
|
||||||
|
|
||||||
## Fixed
|
## Fixed
|
||||||
|
|
||||||
|
|||||||
@@ -40,7 +40,7 @@ Docs is a collaborative text editor designed to address common challenges in kno
|
|||||||
* 📚 Built-in wiki functionality to turn your team's collaborative work into organized knowledge `ETA 02/2025`
|
* 📚 Built-in wiki functionality to turn your team's collaborative work into organized knowledge `ETA 02/2025`
|
||||||
|
|
||||||
### Self-host
|
### Self-host
|
||||||
* 🚀 Easy to install, scalable and secure alternative to Notion, Outline or Confluence
|
* 🚀 Easy to install, scalable and secure alternative to Notion and Outline.
|
||||||
|
|
||||||
## Getting started 🔧
|
## Getting started 🔧
|
||||||
|
|
||||||
@@ -100,26 +100,6 @@ password: impress
|
|||||||
$ make run
|
$ make run
|
||||||
```
|
```
|
||||||
|
|
||||||
⚠️ For the frontend developer, it is often better to run the frontend in development mode locally.
|
|
||||||
|
|
||||||
To do so, install the frontend dependencies with the following command:
|
|
||||||
|
|
||||||
```shellscript
|
|
||||||
$ make frontend-development-install
|
|
||||||
```
|
|
||||||
|
|
||||||
And run the frontend locally in development mode with the following command:
|
|
||||||
|
|
||||||
```shellscript
|
|
||||||
$ make run-frontend-development
|
|
||||||
```
|
|
||||||
|
|
||||||
To start all the services, except the frontend container, you can use the following command:
|
|
||||||
|
|
||||||
```shellscript
|
|
||||||
$ make run-backend
|
|
||||||
```
|
|
||||||
|
|
||||||
**Adding content**
|
**Adding content**
|
||||||
You can create a basic demo site by running:
|
You can create a basic demo site by running:
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,92 @@
|
|||||||
|
# Run Docs locally
|
||||||
|
|
||||||
|
> ⚠️ Running Docs locally using the methods described below is for testing purposes only. It is based on building Docs using Minio as the S3 storage solution: if you want to use Minio for production deployment of Docs, you will need to comply with Minio's AGPL-3.0 licence.
|
||||||
|
|
||||||
|
**Prerequisite**
|
||||||
|
|
||||||
|
Make sure you have a recent version of Docker and [Docker Compose](https://docs.docker.com/compose/install) installed on your laptop:
|
||||||
|
|
||||||
|
```shellscript
|
||||||
|
$ docker -v
|
||||||
|
|
||||||
|
Docker version 20.10.2, build 2291f61
|
||||||
|
|
||||||
|
$ docker compose version
|
||||||
|
|
||||||
|
Docker Compose version v2.32.4
|
||||||
|
```
|
||||||
|
|
||||||
|
> ⚠️ You may need to run the following commands with sudo but this can be avoided by adding your user to the `docker` group.
|
||||||
|
|
||||||
|
**Project bootstrap**
|
||||||
|
|
||||||
|
The easiest way to start working on the project is to use GNU Make:
|
||||||
|
|
||||||
|
```shellscript
|
||||||
|
$ make bootstrap FLUSH_ARGS='--no-input'
|
||||||
|
```
|
||||||
|
|
||||||
|
This command builds the `app` container, installs dependencies, performs database migrations and compile translations. It's a good idea to use this command each time you are pulling code from the project repository to avoid dependency-related or migration-related issues.
|
||||||
|
|
||||||
|
Your Docker services should now be up and running 🎉
|
||||||
|
|
||||||
|
You can access to the project by going to <http://localhost:3000>.
|
||||||
|
|
||||||
|
You will be prompted to log in, the default credentials are:
|
||||||
|
|
||||||
|
```
|
||||||
|
username: impress
|
||||||
|
password: impress
|
||||||
|
```
|
||||||
|
|
||||||
|
📝 Note that if you need to run them afterwards, you can use the eponym Make rule:
|
||||||
|
|
||||||
|
```shellscript
|
||||||
|
$ make run
|
||||||
|
```
|
||||||
|
|
||||||
|
**Adding content**
|
||||||
|
You can create a basic demo site by running:
|
||||||
|
|
||||||
|
```shellscript
|
||||||
|
$ make demo
|
||||||
|
```
|
||||||
|
|
||||||
|
Finally, you can check all available Make rules using:
|
||||||
|
|
||||||
|
```shellscript
|
||||||
|
$ make help
|
||||||
|
```
|
||||||
|
|
||||||
|
**Django admin**
|
||||||
|
|
||||||
|
You can access the Django admin site at
|
||||||
|
|
||||||
|
<http://localhost:8071/admin>.
|
||||||
|
|
||||||
|
You first need to create a superuser account:
|
||||||
|
|
||||||
|
```shellscript
|
||||||
|
$ make superuser
|
||||||
|
```
|
||||||
|
|
||||||
|
## Front-end dev instructions
|
||||||
|
⚠️ For the frontend developer, it is often better to run the frontend in development mode locally.
|
||||||
|
|
||||||
|
To do so, install the frontend dependencies with the following command:
|
||||||
|
|
||||||
|
```shellscript
|
||||||
|
$ make frontend-development-install
|
||||||
|
```
|
||||||
|
|
||||||
|
And run the frontend locally in development mode with the following command:
|
||||||
|
|
||||||
|
```shellscript
|
||||||
|
$ make run-frontend-development
|
||||||
|
```
|
||||||
|
|
||||||
|
To start all the services, except the frontend container, you can use the following command:
|
||||||
|
|
||||||
|
```shellscript
|
||||||
|
$ make run-backend
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user