https://github.com/appflowy-io/appflowy-cloud
Bring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.
https://github.com/appflowy-io/appflowy-cloud
Last synced: about 1 year ago
JSON representation
Bring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.
- Host: GitHub
- URL: https://github.com/appflowy-io/appflowy-cloud
- Owner: AppFlowy-IO
- License: agpl-3.0
- Created: 2021-06-16T13:04:53.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2025-04-12T14:22:19.000Z (about 1 year ago)
- Last Synced: 2025-04-13T01:59:35.143Z (about 1 year ago)
- Language: Rust
- Homepage: https://appflowy.com
- Size: 16.2 MB
- Stars: 1,406
- Watchers: 19
- Forks: 339
- Open Issues: 73
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
⚡ The AppFlowy Cloud written with Rust 🦀
# AppFlowy Cloud
AppFlowy Cloud is part of the AppFlowy ecosystem, offering secure user authentication, file storage,
and real-time WebSocket communication for an efficient and collaborative user experience.
## Table of Contents
- [🚀 Deployment](#-deployment)
- [💻 Development](#-development)
- [🐞 Debugging](#-debugging)
- [⚙️ Contributing](#-contributing)
## 🚀 Deployment
- See [deployment guide](./doc/DEPLOYMENT.md)
## 💻 Development
### Pre-requisites
You'll need to install:
- [Rust](https://www.rust-lang.org/tools/install)
- [Docker](https://docs.docker.com/get-docker/)
### Configuration
- copy the configurations from `dev.env` to `.env`
- edit the `.env` as required (such as SMTP configurations)
### Run with all dependencies
```bash
./script/run_local_server.sh
```
This process will execute all the dependencies and start the AppFlowy-Cloud server. Alternatively,
you have the option to run the AppFlowy-Cloud server independently
### Run the AppFlowy-Cloud
1. Run the dependency servers
```bash
docker compose --file docker-compose-dev.yml up -d
```
2. Install sqlx-cli
```bash
cargo install sqlx-cli
```
3. Run sqlx migration
```bash
sqlx database create
sqlx migrate run
cargo sqlx prepare --workspace
```
4. Run the server
```bash
cargo run
```
### Run the tests
After the server is running, you can run the tests with:
```bash
cargo test
```
## 🐞Debugging
Effective debugging is essential for maintaining a healthy application. Here are some tools and commands to help you
troubleshoot issues in various components of the AppFlowy cloud server:
### Postgres
A web-based administration tool for PostgreSQL. Access it at [PgAdmin](http://localhost:5400)
- OR command line:
```bash
export PGPASSWORD=password
psql --host=localhost --username=postgres --port=5432
```
- Redis
Redis offers a powerful command line interface for managing your Redis instance. Connect using the following command:
```bash
redis-cli -p 6379
```
### Minio
Minio provides a Web UI for easy management of your files and buckets. Access it at [Web UI](http://localhost:9001)
### Portainer
For managing Docker containers, Portainer's Web UI is an excellent tool. Access it at Web UI to easily manage Docker
environments, including container deployment, networking, volume management, and more. Access it
at [Web UI](http://localhost:9442)
## ⚙️ Contributing
Any new contribution is more than welcome in this project!
If you want to know more about the development workflow or want to contribute, please visit
our [contributing guidelines](./doc/CONTRIBUTING.md) for detailed instructions!