Skip to content

Commit fdd8fbb

Browse files
committed
Updated docker setup, updated README
1 parent 73d508f commit fdd8fbb

File tree

2 files changed

+45
-19
lines changed

2 files changed

+45
-19
lines changed

README.md

Lines changed: 43 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -102,40 +102,66 @@ In the "Saved" tab you can:
102102

103103
This 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
114113
cd 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
129150
git clone https://github.com/davistdaniel/kurup
130151
cd 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:
136160
http://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
165188
sudo docker compose down
189+
# pull the latest image
190+
sudo docker compose pull
191+
# start the container
166192
sudo docker compose up -d
167193

168194
# Open your web browser and navigate to:

docker-compose.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ services:
55
ports:
66
- "9494:9494"
77
volumes:
8-
- notes:/app/notes # make sure the notes folder exists before running the container‚ otherwise the folder will be owned by root.
8+
- ./notes:/app/notes # make sure the notes folder exists before running the container‚ otherwise the folder will be owned by root.
99
# you can also use a custom path for the notes directory
1010
#- /home/yourusername/Documents/notes:/app/notes
1111
command: ["--notes_dir", "/app/notes"]
12-
user: "1000:1000" # set to your own local UID:GID, run `id -u` to find UID and run `id -g` to find GID
12+
user: "1000:1000" # set to your own local UID:GID, run `id -u` to find UID and run `id -g` to find GID

0 commit comments

Comments
 (0)