@@ -102,40 +102,66 @@ In the "Saved" tab you can:
102102
103103This project is under active development. Please make a separate backup of your notes.
104104
105- ### Prerequisites
106105
107- - Python 3.11 or higher
108106
109- ### Using Python
107+ ### Using Docker (Recommended)
108+
109+ #### 1. Make a directory for kurup and the notes
110110
111111``` bash
112- # Clone the repository
113- git clone https://github.com/davistdaniel/kurup
112+ mkdir -p kurup/notes
114113cd kurup
114+ ```
115115
116- # Install dependencies
117- python -m pip install " nicegui>=2.17.0"
116+ #### 2. Make a docker-compose.yml file in the kurup folder with the following contents:
117+ ``` bash
118+ services:
119+ kurup:
120+ image: ghcr.io/davistdaniel/kurup:latest
121+ container_name: kurup
122+ ports:
123+ - " 9494:9494"
124+ volumes:
125+ - ./notes:/app/notes # make sure the notes folder exists before running the container‚ otherwise the folder will be owned by root.
126+ # you can also use a custom path for the notes directory
127+ # - /home/yourusername/Documents/notes:/app/notes
128+ command: [" --notes_dir" , " /app/notes" ]
129+ user: " 1000:1000" # set to your own local UID:GID, run `id -u` to find UID and run `id -g` to find GID
130+ ```
118131
119- # Run the application
120- python main.py
132+ #### 3. Start the container
121133
122- # Open your web browser and navigate to:
123- http://localhost:9494
134+ ``` bash
135+ sudo docker compose up -d
124136```
125137
126- ### Using Docker (using NiceGUI's docker image)
138+ #### 4. Open your web browser and navigate to:
139+
140+ http://localhost:9494
141+
142+ ### Using Python (Tested on Linux, MacOS)
143+
144+ #### Prerequisites
145+
146+ - Python 3.11 or higher
147+
127148``` bash
128149# Clone the repository
129150git clone https://github.com/davistdaniel/kurup
130151cd kurup
131152
132- # start the container, you can edit docker-compose.yml to configure
133- sudo docker compose up -d
153+ # Install dependencies
154+ python -m pip install " nicegui>=2.17.0"
155+
156+ # Run the application
157+ python main.py
134158
135159# Open your web browser and navigate to:
136160http://localhost:9494
137161```
138162
163+
164+
139165## 🔄 Updating
140166
141167> [ !NOTE]
@@ -158,11 +184,11 @@ http://localhost:9494
158184
159185### Docker
160186``` bash
161- # Pull the latest changes from the repository
162- git pull origin main
163-
164187# restart the container
165188sudo docker compose down
189+ # pull the latest image
190+ sudo docker compose pull
191+ # start the container
166192sudo docker compose up -d
167193
168194# Open your web browser and navigate to:
0 commit comments