memEx/readme.md

90 lines
4.0 KiB
Markdown
Raw Normal View History

2022-11-26 20:36:09 -05:00
# memEx
2022-01-22 23:44:47 -05:00
2022-11-26 23:20:11 -05:00
![old screenshot](https://gitea.bubbletea.dev/shibao/memEx/raw/branch/stable/home.png)
2022-11-26 20:36:09 -05:00
memEx is an easy way to digitize the structured processes of your life.
2022-10-26 22:08:59 -04:00
- Notes: Document notes about individual items or concepts
- Contexts: Provide context around a single topic and hotlink to individual
concepts in your notes
- Pipelines: Document your processes, attaching contexts to each step.
2022-01-22 23:44:47 -05:00
# Features
2022-10-26 22:08:59 -04:00
- Multi-user: Built with sharing and collaboration in mind
- Privacy: Privacy controls on a per-note, context or pipeline basis
- Convenient: Accessible from any internet-capable device
2022-01-22 23:44:47 -05:00
# Installation
2022-02-25 21:35:12 -05:00
1. Install [Docker Compose](https://docs.docker.com/compose/install/) or alternatively [Docker Desktop](https://docs.docker.com/desktop/) on your machine.
2022-11-26 20:36:09 -05:00
1. Copy the example [docker-compose.yml](https://gitea.bubbletea.dev/shibao/memEx/src/branch/stable/docker-compose.yml). into your local machine where you want.
2022-02-25 21:35:12 -05:00
Bind mounts are created in the same directory by default.
1. Set the configuration variables in `docker-compose.yml`. You'll need to run
2022-07-25 19:31:54 -04:00
`docker run -it shibaobun/memex /app/priv/random.sh` to generate a new
2022-02-25 21:35:12 -05:00
secret key base.
1. Use `docker-compose up` or `docker-compose up -d` to start the container!
2022-01-22 23:44:47 -05:00
2022-02-25 21:35:12 -05:00
The first created user will be created as an admin.
2022-01-22 23:44:47 -05:00
2022-02-25 21:35:12 -05:00
# Configuration
2022-01-22 23:44:47 -05:00
2022-11-26 20:36:09 -05:00
You can use the following environment variables to configure memEx in
[docker-compose.yml](https://gitea.bubbletea.dev/shibao/memEx/src/branch/stable/docker-compose.yml).
2022-01-22 23:44:47 -05:00
2022-02-25 21:35:12 -05:00
- `HOST`: External url to generate links with. Must be set with your hosted
2022-07-25 19:31:54 -04:00
domain name! I.e. `memex.mywebsite.tld`
2022-02-25 21:35:12 -05:00
- `PORT`: Internal port to bind to. Defaults to `4000`. Must be reverse proxied!
2022-01-22 23:44:47 -05:00
- `DATABASE_URL`: Controls the database url to connect to. Defaults to
2022-07-25 19:31:54 -04:00
`ecto://postgres:postgres@memex-db/memex`.
2022-02-25 21:35:12 -05:00
- `ECTO_IPV6`: If set to `true`, Ecto should use ipv6 to connect to PostgreSQL.
2022-01-22 23:44:47 -05:00
Defaults to `false`.
- `POOL_SIZE`: Controls the pool size to use with PostgreSQL. Defaults to `10`.
- `SECRET_KEY_BASE`: Secret key base used to sign cookies. Must be generated
2022-07-25 19:31:54 -04:00
with `docker run -it shibaobun/memex mix phx.gen.secret` and set for server to start.
2022-02-25 21:35:12 -05:00
- `REGISTRATION`: Controls if user sign-up should be invite only or set to
public. Set to `public` to enable public registration. Defaults to `invite`.
2022-05-05 20:55:59 -04:00
- `LOCALE`: Sets a custom default locale. Defaults to `en_US`.
2022-02-25 21:35:12 -05:00
- `SMTP_HOST`: The url for your SMTP email provider. Must be set
- `SMTP_PORT`: The port for your SMTP relay. Defaults to `587`.
- `SMTP_USERNAME`: The username for your SMTP relay. Must be set!
- `SMTP_PASSWORD`: The password for your SMTP relay. Must be set!
- `SMTP_SSL`: Set to `true` to enable SSL for emails. Defaults to `false`.
- `EMAIL_FROM`: Sets the sender email in sent emails. Defaults to
`no-reply@HOST` where `HOST` was previously defined.
2022-11-27 21:23:27 -05:00
- `EMAIL_NAME`: Sets the sender name in sent emails. Defaults to "memEx".
2022-01-22 23:44:47 -05:00
2023-03-19 00:46:21 -04:00
# Contribution
Contributions are greatly appreciated, no ability to code needed! You can browse
the [Contribution
Guide](https://gitea.bubbletea.dev/shibao/memex/src/branch/stable/contributing.md)
to learn more.
I can be contacted at [shibao@bubbletea.dev](mailto:shibao@bubbletea.dev), or on
the fediverse at
[@shibao@misskey.bubbletea.dev](https://misskey.bubbletea.dev/@shibao). Thank
you!
# License
memEx is licensed under AGPLv3 or later. A copy of the latest version of the
license can be found at
[license.md](https://gitea.bubbletea.dev/shibao/memex/src/branch/stable/license.md).
# Links
- [Gitea](https://gitea.bubbletea.dev/shibao/memex): Main repo, feature
requests and bug reports
- [Github](https://github.com/shibaobun/memex): Source code mirror, please
don't open pull requests to this repository
- [Weblate](https://weblate.bubbletea.dev/engage/memex): Contribute to
translations!
2022-01-23 00:00:11 -05:00
---
[![Build
2022-11-26 20:36:09 -05:00
Status](https://drone.bubbletea.dev/api/badges/shibao/memEx/status.svg?ref=refs/heads/dev)](https://drone.bubbletea.dev/shibao/memEx)
2022-11-26 23:20:11 -05:00
[![translation
status](https://weblate.bubbletea.dev/widgets/memEx/-/svg-badge.svg)](https://weblate.bubbletea.dev/engage/memEx/)