Updated README
authorAdam Dullage <redacted>
Tue, 23 Aug 2022 07:27:20 +0000 (08:27 +0100)
committerAdam Dullage <redacted>
Tue, 23 Aug 2022 07:27:20 +0000 (08:27 +0100)
README.md
docker-compose.yaml [deleted file]

index 0ef6f6e21862a1a98d9a9bee3340dc4233b9460a..5471055d5ea0d0f7643f63fd3a66f8d0f86ea3c4 100644 (file)
--- a/README.md
+++ b/README.md
@@ -10,9 +10,52 @@ Log into the [demo site](https://demo.flatnotes.io) and take a look around. The
 flatnotes is designed to be a distraction free note taking app that puts your note content first. This means:
 
 * A clean and simple user interface.
-* No folders, categories, keywords, notebooks, tags or anything like that. Just all of your notes backed by powerful search functionality.
+* No folders, categories, keywords, notebooks, tags or anything like that. Just all of your notes, backed by powerful search functionality.
 * Quick access to a full text search from anywhere in the app (keyboard shortcut "/").
 
+Another key design principle is not to take your notes hostage. Your notes are just markdown files. There's no database, proprietary formatting, complicated folder structures or anything like that. You're free at any point to just move the files elsewhere and use another app.
+
+Equally, the only thing flatnotes caches is the search index and that's incrementally synced on every search (and when flatnotes first starts). This means that you're free to add, edit & delete the markdown files outside of flatnotes whilst flatnotes is running.
+
+
+## Installation
+
+The easiest way to install flatnotes is using Docker.
+
+### Example Docker Run Command
+
+```shell
+docker run -d \
+  -e "FLATNOTES_USERNAME=user" \
+  -e "FLATNOTES_PASSWORD=changeMe!" \
+  -e "FLATNOTES_SECRET_KEY=aLongRandomSeriesOfCharacters" \
+  -p "80:80" \
+  dullage/flatnotes:latest
+```
+
+### Example Docker Compose
+```yaml
+version: "3"
+
+services:
+  flatnotes:
+    container_name: flatnotes
+    image: dullage/flatnotes:latest
+    environment:
+      FLATNOTES_USERNAME: "user"
+      FLATNOTES_PASSWORD: "changeMe!"
+      FLATNOTES_SECRET_KEY: "aLongRandomSeriesOfCharacters"
+      # FLATNOTES_SESSION_EXPIRY_DAYS: "7"
+      # Optional. Defaults to 30.
+    volumes:
+      - "./data:/data"
+      # - "./index:/data/.flatnotes"
+      # Optional. Allows you to save the search index in a different location. 
+    ports:
+      - "80:80"
+    restart: unless-stopped
+```
+
 
 ## Q&A
 ### Where is the database?
@@ -31,7 +74,7 @@ Yup. The only thing flatnotes caches is the search index and that's synced on ev
 Yes! See the [Advanced Searching](https://github.com/Dullage/flatnotes/wiki/Advanced-Searching) wiki page.
 
 ### How do I get my notes out of flatnotes?
-They're just markdown files. There's no database, proprietary formatting, complicated folder structures or anything like that so you're free to just move the files elsewhere and use another markdown editor.
+They're just markdown files.  You're free to just move the files elsewhere and use another app.
 
 ### Is there an API?
 Yes. The docs are available at the `/docs` endpoint. See [demo.flatnotes.io/docs](https://demo.flatnotes.io/docs) as an example.
diff --git a/docker-compose.yaml b/docker-compose.yaml
deleted file mode 100644 (file)
index 7b940ca..0000000
+++ /dev/null
@@ -1,18 +0,0 @@
-version: "3"
-
-services:
-  flatnotes:
-    container_name: flatnotes
-    image: dullage/flatnotes:latest
-    build: .
-    environment:
-      FLATNOTES_USERNAME: "user"
-      FLATNOTES_PASSWORD: "changeMe!"
-      FLATNOTES_SECRET_KEY: "aLongRandomSeriesOfCharacters"
-      # FLATNOTES_SESSION_EXPIRY_DAYS: "7"                   # Optional. Defaults to 30.
-    volumes:
-      - "./data:/data"
-      # - "./index:/data/.flatnotes"                         # Optional. Allows you to save the search index in a different location. 
-    ports:
-      - "80:80"
-    restart: unless-stopped
git clone https://git.99rst.org/PROJECT