notatio/README.md

106 lines
3.2 KiB
Markdown
Raw Normal View History

2023-11-21 04:10:40 +00:00
# Notatio
![Build Status](https://jinkies.privacyquest.net/buildStatus/icon?job=Notatio%2Fmain)
## 💡 About
**Notatio is currently under heavy development, and as such there is the possibility breaking changes**
Notatio is a self-hostable, containerized, web-based text editor. The main objective of the project is to create a platform independent text editor (and productivity management suite). I hope to develop this as an alterniative to propriatry software like obsidian and Notion.so which I have loved and used in the past. This software is currently being created as part of a Senior Capstone, but there are plans to continue developing it afterwards.
## 🛣️ **Roadmap**
#### In Progress
- 🕓 Building Custom Text Editor
- 🕓 Add Kanban Board
#### Planned V1 Release
- [ ] Flesh out File Management Operations
- [ ] NoSQL setup option
#### Planned V1.1 Release
- [ ] Collaborative Editing
- [ ] File Versiong
#### Planned v1.2 Releaase
- [ ] End to End Encryption
## 💾 **Download**
Downloading Notatio is simple! Just clone the repository using the command below:
```bash
git clone https://codeberg.org/musselman/notatio
```
## 🚀 **Running**
There are two ways to run Notatio.
### 📦**Container (Recommended)**
---
#### Docker
Before running the Docker container, make sure to copy `.env.example` to `.env` and customize the environment variables to your preferences:
```bash
cp .env.example .env
```
Launch the containers using the following command:
```bash
docker-compose up -d
```
#### Podman (Alternative to Docker)
1. Make sure you have Podman and Podman-Compose installed on your system.
2. Copy `.env.example` to `.env` and modify the environment variables as per your requirements.
3. Edit the docker-compose.yaml to have `:Z`'s at the end of volumes. This is to tell SELinux that the volumes should be labeled with the appropriate security context.
4. Launch the containers using the following command:
```bash
podman-compose up -d
```
Please note that using Podman instead of Docker requires you to have Podman installed and properly configured on your system. The usage and setup of Podman may differ from Docker, so please consult the Podman documentation for further information.
### 🛠️ Go Binary (Advanced)
---
Note: This setup requires a running PostgreSQL database. Please set it up before proceeding.
To run Notatio using the Go binary, follow the steps below:
1. Build the Go binary.
2. Pass the necessary environment variables to the program, editing them to provide the required information for your database.
Example command:
```bash
DB_HOST=127.0.0.1 PGPORT=5432 DB_USER=postgres POSTGRES_PASSWORD=mysecretpassword DB_SSL_MODE=disable ADMIN_USER=admin_user ADMIN_PASS=admin_is_not_a_good_password! ./notatio
```
Please note that this method is more advanced and requires additional setup.
## 🤝 Contributing
As this is currently an accademic project I cannot accept contributions! If you are interested in doing so please reach out to me on or after December 7th.
<!---All contributions are welcome. Please take a look at [contributing](./CONTRIBUTING.md) guide. -->
## 📄 License
This project is licensed under the AGPL - see the [LICENSE](./LICENSE) file for details