AppFlowy Docs
Search…
Docker
A simple way of running AppFlowy is with the use of a Docker container. And we have one for you at Docker Hub!
1
docker run --rm \
2
-v $HOME/.Xauthority:/root/.Xauthority:rw \
3
-v /tmp/.X11-unix:/tmp/.X11-unix \
4
-v /dev/dri:/dev/dri \
5
-v /var/run/dbus/system_bus_socket:/var/run/dbus/system_bus_socket \
6
-v appflowy-data:/home/appflowy \
7
-e DISPLAY=${DISPLAY} \
8
appflowyio/appflowy_client:latest
Copied!
Note: Appflowy inside docker needs access to your X server. In case of lack of permissions, it's recommended to build the docker image yourself. The least recommended option is running xhost + before running the container, but this command is considered dangerous! So make sure you run xhost - after it.

Building the docker image

First thing to do

Make sure you already have Docker and docker-compose fully working before attempting this procedure.
For more information, check out:
In order to run Docker without sudo you must add your username to the docker group. To do this use the following command and then logout and login for it to take effect.
1
sudo usermod -aG docker yourusername
Copied!

Building without cloning the repository

There is no need to clone the whole repository. You can simply create a directory and download the required Docker files into that directory.
1
wget https://raw.githubusercontent.com/AppFlowy-IO/appflowy/main/frontend/scripts/docker-buildfiles/Dockerfile
2
wget https://raw.githubusercontent.com/AppFlowy-IO/appflowy/main/frontend/scripts/docker-buildfiles/docker-compose.yml
Copied!
Now you are ready to build the docker image (this can take some time)
1
docker-compose build --build-arg uid=$(id -u) --build-arg gid=$(id -g)
Copied!
Lastly, run the docker container
1
docker-compose up
Copied!

Building with the repository installed

If you already have the repository installed then you're halfway there!
1
cd ./frontend/scripts/docker-buildfiles
2
docker-compose build --build-arg uid=$(id -u) --build-arg gid=$(id -g)
Copied!
Lastly, run the docker container
1
docker-compose up
Copied!