Many Notes is a markdown note-taking app designed for simplicity! Easily create or import your vaults and organize your thoughts right away. Vaults are simply storage containers for your files, and Many Notes lets you choose to keep all your files in one vault or organize them into separate vaults. ## Screenshots  *Light theme*  *Dark theme* ## Features - Multiple users - Multiple vaults per user - OAuth support - File search - Tree view explorer with context menu - Smart markdown editor - Import/export vaults - Light/dark theme (automatically selected by your OS setting) - Mobile friendly ## Installation (Docker) **Read the [upgrading guide](UPGRADING.md) if you are upgrading from a previous version.** First, create a new directory called `many-notes` with the following structure: ``` many-notes/ ├── storage-logs/ ├── storage-private/ ├── storage-public/ ├── storage-sessions/ ├── compose.yaml ├── database.sqlite └── Dockerfile ``` Next, add this to the `Dockerfile` file: ```Dockerfile FROM brufdev/many-notes:latest USER root ARG UID ARG GID RUN docker-php-serversideup-set-id www-data $UID:$GID && \ docker-php-serversideup-set-file-permissions --owner $UID:$GID --service nginx USER www-data ``` Finally, add this to the `compose.yaml` file: ```yaml services: php: build: context: . args: UID: USER_ID # change id GID: GROUP_ID # change id restart: unless-stopped volumes: - ./database.sqlite:/var/www/html/database/database.sqlite - ./storage-logs:/var/www/html/storage/logs - ./storage-private:/var/www/html/storage/app/private - ./storage-public:/var/www/html/storage/app/public - ./storage-sessions:/var/www/html/storage/framework/sessions ports: - 80:8080 ``` Many Notes must have the necessary permissions to access the shared paths. Since this image runs with an unprivileged user, the host user IDs must be added during the build phase. Make sure to update the IDs to match the host user IDs. Feel free to change anything else if you know what you're doing, and read the customization section below before continue. Then run: ```shell docker compose up -d ``` ## Customization You can customize Many Notes by adding environment variables to the `compose.yaml` file. ### Custom URL (default: http://localhost) If you change the default port from 80 or use a reverse proxy with a custom URL, make sure to configure the application URL accordingly. For example, if you change the port to 8080, add: ```yaml environment: - APP_URL=http://localhost:8080 - ASSET_URL=http://localhost:8080 ``` ### Custom timezone (default: UTC) Check all available timezones [here](https://www.php.net/manual/en/timezones.php). For example, if you want to set the timezone to Amsterdam, add: ```yaml environment: - APP_TIMEZONE=Europe/Amsterdam ``` ### Custom upload size limit (default: 500M) Increase the upload size limit to allow for the import of larger files. For example, if you want to increase the limit to 1 GB, add: ```yaml environment: - PHP_POST_MAX_SIZE=1G - PHP_UPLOAD_MAX_FILE_SIZE=1G ``` ### Enable OAuth providers Many Notes supports a convenient way to authenticate with OAuth providers. Typically, these credentials may be retrieved by creating a "developer application" within the dashboard of the service you wish to use. Many Notes currently supports authentication via Facebook, Twitter, LinkedIn, Google, GitHub, GitLab, Bitbucket, Slack, Authentik, and Keycloak. You can enable multiple providers simultaneously by adding the corresponding environment variables. For example, to enable GitHub OAuth, add: ```yaml environment: - GITHUB_CLIENT_ID=CLIENT_ID # change id - GITHUB_CLIENT_SECRET=CLIENT_SECRET # change secret - GITHUB_REDIRECT_URI=http://localhost/oauth/github/callback # change uri ``` **Authentik and Keycloak providers require additional configuration.** To enable GitHub OAuth, add: ```yaml environment: - AUTHENTIK_BASE_URL=http://your-authentik-domain # change url - AUTHENTIK_CLIENT_ID=CLIENT_ID # change id - AUTHENTIK_CLIENT_SECRET=CLIENT_SECRET # change secret - AUTHENTIK_REDIRECT_URI=http://localhost/oauth/authentik/callback # change uri ``` To enable Keycloak OAuth, add: ```yaml environment: - KEYCLOAK_BASE_URL=http://your-keycloak-domain # change url - KEYCLOAK_CLIENT_ID=CLIENT_ID # change id - KEYCLOAK_CLIENT_SECRET=CLIENT_SECRET # change secret - KEYCLOAK_REDIRECT_URI=http://localhost/oauth/keycloak/callback # change uri - KEYCLOAK_REALM=YOUR_REALM # change realm ``` ### Custom email service Configure an email service to send registration and password reset emails by adding: ```yaml environment: - MAIL_MAILER=smtp - MAIL_HOST=127.0.0.1 - MAIL_PORT=2525 - MAIL_USERNAME=null - MAIL_PASSWORD=null - MAIL_ENCRYPTION=null - MAIL_FROM_ADDRESS=hello@example.com - MAIL_FROM_NAME="Many Notes" ``` ## License This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for the full license text.